Diagnosis flow
从连接到方法列表逐项收敛
1
先校验目标地址明确提示 gRPC 需要 host:port,不要填 REST path 或查询参数。
2
再检查传输和 Metadata展示 plaintext/TLS、Metadata 解析数量和 Auth 配置是否参与本次探测。
3
最后确认 schema 来源区分 Reflection 成功、Proto fallback 和未知状态,避免用户只看到一个失败码。
Evidence
诊断结果要能复制给同事
链路运行报告和 Doctor 结果都围绕“证据 + 建议”组织。失败时至少需要知道是哪一步失败、 使用了哪个 schema 来源、有没有附加 Metadata,以及下一步应该改地址、TLS、Auth 还是 Proto。
Matrix
诊断能力矩阵
| 检查项 | 说明 | 状态 |
|---|---|---|
| 地址格式 | host:port 校验、HTTP 路径误填提示 | 已实现 |
| 传输配置 | plaintext/TLS、服务名覆盖、证书配置 | 已实现 |
| Metadata/Auth | Bearer/API Key/Basic/Custom Metadata 解析 | 已实现 |
| Server Reflection | 列出服务和方法,记录 reflection error | 已实现 |
| Proto fallback | Reflection 失败后复用已绑定 Proto | 已实现 |
| History Diff | 对比 status、duration、body、metadata、trailers | 已实现 |