gRPC Doctor

连不上、反射失败、鉴权异常
先让诊断面板给证据

Doctor 面板不是泛泛提示,它围绕 gRPC 调试最常见的失败点拆步骤:目标地址、传输、安全配置、Metadata、Reflection、Proto fallback 和方法读取。

gRPC Doctor Evidence first
6/6checks passed
host:port target plaintext transport metadata parsed reflection service proto fallback ready
reflection.listServices: OK · 120ms
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 已实现