gRPC 接口测试是什么
gRPC 是基于 HTTP/2 的远程调用框架，接口由 .proto 文件定义。测试时用 .proto 生成客户端桩，或使用 grpcurl 一类命令行工具发起调用，重点校验：状态码是否符合语义、metadata 鉴权是否生效、deadline 与取消能否正确传播、流式接口（服务端流、客户端流、双向流）行为是否符合预期。
基本信息
| 接口定义 | protobuf（.proto）定义方法、消息与字段编号 |
|---|---|
| 调用工具 | 生成的客户端桩、grpcurl 等命令行工具 |
| 鉴权方式 | metadata 携带令牌（类似 HTTP 头部） |
| 超时控制 | deadline 设置与取消传播到下游 |
| 流式类型 | 服务端流、客户端流、双向流 |
| 常见障碍 | 浏览器与普通 HTTP 工具难以直接调用 |
调用与状态码示例
调用与状态码示例
调用示例（grpcurl 风格）：
grpcurl -plaintext -d '{"name":"alice"}' localhost:50051 demo.User/Get
高频状态码：
OK / INVALID_ARGUMENT / UNAUTHENTICATED
PERMISSION_DENIED / NOT_FOUND / DEADLINE_EXCEEDED典型使用场景
- 微服务接口测试：对内部 RPC 方法做参数与状态码覆盖。
- 契约验证：以 .proto 为准校验字段编号与必填语义，防止破坏兼容。
- 鉴权与越权测试：无令牌、过期令牌、越权角色的状态码差异。
- 超时链路验证：上游 deadline 设置后，观察下游取消传播与资源释放。
- 流式场景：服务端分批推送、客户端上传、双向消息的顺序与结束语义。
- 性能基线：结合压测工具对关键 RPC 做延迟与吞吐基线。
常见状态码读法
| 状态码 | 含义 | 测试含义 |
|---|---|---|
| OK | 成功 | 正向用例的目标状态 |
| INVALID_ARGUMENT | 参数非法 | 校验未生效或校验过严都要查 |
| UNAUTHENTICATED | 未认证 | 空令牌与错误令牌均应返回 |
| PERMISSION_DENIED | 无权限 | 越权测试的期望结果 |
| NOT_FOUND | 资源不存在 | 区分「不存在」与「无权限」的返回 |
| DEADLINE_EXCEEDED | 超时 | deadline 过短场景与下游慢调用 |
gRPC 基于 HTTP/2 传输：用浏览器或普通 HTTP 工具直接测容易在协议层失败，应使用生成的客户端或 grpcurl 一类专用工具。
状态码是断言重点：把「参数错」返回成 UNAVAILABLE 这类语义漂移，会误导上游的重试与告警策略。
确认测试环境通道配置（明文或 TLS）与目标环境一致，否则证书与连接问题混入用例结果。