gRPC

gRPC 1 CANCELLED vs 9 FAILED_PRECONDITION

Both gRPC 1 (CANCELLED) and 9 (FAILED_PRECONDITION) belong to the gRPC Status Codes category. 1 indicates that the operation was cancelled, typically by the caller. Meanwhile, 9 means that the operation was rejected because the system is not in a state required for the operation's execution. For example, deleting a non-empty directory.

Descripción

The operation was cancelled, typically by the caller.

Cuándo lo verás

The client explicitly cancelled the RPC, or a deadline or context cancellation propagated to the server before it could finish processing.

Cómo solucionarlo

If unexpected, check whether the client is setting too-short deadlines or if cancellation is being triggered inadvertently in your call chain.

Descripción

The operation was rejected because the system is not in a state required for the operation's execution. For example, deleting a non-empty directory.

Cuándo lo verás

The request is valid on its own, but the system's current state doesn't allow it — like trying to delete a non-empty directory or update a resource that has been modified concurrently.

Cómo solucionarlo

Bring the system into the required state before retrying. For example, empty the directory first, or re-read the resource to get the latest version before updating.

Diferencias clave

1.

gRPC 1: The operation was cancelled, typically by the caller.

2.

gRPC 9: The operation was rejected because the system is not in a state required for the operation's execution. For example, deleting a non-empty directory.

3.

You encounter 1 when the client explicitly cancelled the RPC, or a deadline or context cancellation propagated to the server before it could finish processing.

4.

You encounter 9 when the request is valid on its own, but the system's current state doesn't allow it — like trying to delete a non-empty directory or update a resource that has been modified concurrently.

Cuándo usar cada uno

For 1 (CANCELLED): If unexpected, check whether the client is setting too-short deadlines or if cancellation is being triggered inadvertently in your call chain. For 9 (FAILED_PRECONDITION): Bring the system into the required state before retrying. For example, empty the directory first, or re-read the resource to get the latest version before updating.

Saber más