gRPC

gRPC 5 NOT_FOUND vs 12 UNIMPLEMENTED

Both gRPC 5 (NOT_FOUND) and 12 (UNIMPLEMENTED) belong to the gRPC Status Codes category. 5 indicates that some requested entity was not found. For example, a file or directory that the RPC was supposed to operate on does not exist. Meanwhile, 12 means that the operation is not implemented or is not supported/enabled in this service.

説明

Some requested entity was not found. For example, a file or directory that the RPC was supposed to operate on does not exist.

このコードが表示される場合

The resource referenced in the request doesn't exist — such as looking up a user by ID that has been deleted or never created.

解決方法

Verify the resource identifier is correct. Ensure the resource was created before accessing it, or handle the not-found case gracefully in your client.

説明

The operation is not implemented or is not supported/enabled in this service.

このコードが表示される場合

The client called an RPC method that the server does not implement. This often happens when the client uses a newer proto definition than the server supports.

解決方法

Verify the server version supports the method you're calling. Update the server to implement the missing method, or use an alternative endpoint.

主な違い

1.

gRPC 5: Some requested entity was not found. For example, a file or directory that the RPC was supposed to operate on does not exist.

2.

gRPC 12: The operation is not implemented or is not supported/enabled in this service.

3.

You encounter 5 when the resource referenced in the request doesn't exist — such as looking up a user by ID that has been deleted or never created.

4.

You encounter 12 when the client called an RPC method that the server does not implement. This often happens when the client uses a newer proto definition than the server supports.

どちらをいつ使うか

For 5 (NOT_FOUND): Verify the resource identifier is correct. Ensure the resource was created before accessing it, or handle the not-found case gracefully in your client. For 12 (UNIMPLEMENTED): Verify the server version supports the method you're calling. Update the server to implement the missing method, or use an alternative endpoint.

詳しく見る