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.
Description
The operation was cancelled, typically by the caller.
Quand vous le voyez
The client explicitly cancelled the RPC, or a deadline or context cancellation propagated to the server before it could finish processing.
Comment résoudre
If unexpected, check whether the client is setting too-short deadlines or if cancellation is being triggered inadvertently in your call chain.
Description
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.
Quand vous le voyez
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.
Comment résoudre
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.
Différences clés
gRPC 1: The operation was cancelled, typically by the caller.
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.
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.
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.
Quand utiliser lequel
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.