GRPC 错误码表

code	数	描述
OK	0	不是错误;成功返回。
CANCELLED	1	操作通常由调用方取消。
UNKNOWN	2	未知错误。例如，当从另一个地址空间接收的值属于此地址空间中未知的错误空间时，可能会返回此错误。此外，未返回足够错误信息的 API 引发的错误可能会转换为此错误。Status
INVALID_ARGUMENT	3	客户端指定了无效的参数。请注意，这与 不同。 表示无论系统状态如何（例如，文件格式不正确）都存在问题的参数。FAILED_PRECONDITION INVALID_ARGUMENT
DEADLINE_EXCEEDED	4	截止时间在操作完成之前已过期。对于更改系统状态的操作，即使操作已成功完成，也可能会返回此错误。例如，来自服务器的成功响应可能会延迟很长时间
NOT_FOUND	5	未找到某些请求的实体（例如，文件或目录）。服务器开发人员注意：如果整个类别的用户的请求被拒绝，则可以使用逐步推出功能或未记录的允许列表。如果拒绝一类用户中某些用户的请求，则必须使用基于用户的访问控制。NOT_FOUND PERMISSION_DENIED
ALREADY_EXISTS	6	客户端尝试创建的实体（例如，文件或目录）已存在。
PERMISSION_DENIED	7	调用方没有执行指定操作的权限。 不得用于因耗尽某些资源而导致的拒绝（改用这些错误）。 如果无法识别调用方，则不得使用（对于这些错误，则改用）。此错误代码并不意味着请求有效，也不表示请求的实体存在或满足其他前提条件。PERMISSION_DENIEDRESOURCE_EXHAUSTEDPERMISSION_DENIEDUNAUTHENTICATED
RESOURCE_EXHAUSTED	8	某些资源已用尽，可能是每个用户的配额，或者可能是整个文件系统空间不足。
FAILED_PRECONDITION	9	该操作被拒绝，因为系统未处于执行该操作所需的状态。例如，要删除的目录为非空目录，将 rmdir 操作应用于非目录等。服务实现者可以使用以下准则来决定 、 和 ： （a） 如果客户端可以只重试失败的调用，则使用。（b） 如果客户端应该在更高级别重试（例如，当客户端指定的测试和设置失败时，指示客户端应重新启动读-修改-写入序列），则使用该命令。（c） 如果客户端在系统状态被显式修复之前不应重试，则使用。例如，如果“rmdir”因为目录不为空而失败，则应返回，因为除非从目录中删除文件，否则客户端不应重试。FAILED_PRECONDITIONABORTEDUNAVAILABLEUNAVAILABLEABORTEDFAILED_PRECONDITIONFAILED_PRECONDITION
ABORTED	10	操作已中止，通常是由于并发问题（如排序器检查失败或事务中止）造成的。请参阅上面的准则，在 、 和 之间做出决定。FAILED_PRECONDITION ABORTED UNAVAILABLE
OUT_OF_RANGE	11	尝试的操作超出了有效范围。例如，查找或读取过去的文件末尾。与 不同，此错误表示如果系统状态发生更改，该问题可能会得到解决。例如，如果要求以不在 [32,0^2-32] 范围内的偏移量读取，则将生成 1 位文件系统，但如果要求从超过当前文件大小的偏移量读取，则将生成 <> 位文件系统。和 之间存在相当多的重叠。我们建议在应用时使用（更具体的错误），以便循环访问空间的调用方可以轻松查找错误以检测错误何时完成。INVALID_ARGUMENTINVALID_ARGUMENTOUT_OF_RANGEFAILED_PRECONDITIONOUT_OF_RANGEOUT_OF_RANGEOUT_OF_RANGE
UNIMPLEMENTED	12	此服务中未实现或不支持/启用该操作。
INTERNAL	13	内部错误。这意味着底层系统预期的一些不变量已被打破。此错误代码保留用于严重错误。
UNAVAILABLE	14	该服务目前不可用。这很可能是暂时性情况，可以通过回退重试来纠正。请注意，重试非幂等操作并不总是安全的。
DATA_LOSS	15	不可恢复的数据丢失或损坏。
UNAUTHENTICATED	16	该请求没有用于该操作的有效身份验证凭据。