Evans：交互式 gRPC 会话如何保持可解释
REPL 的优势是上下文，也是风险
Evans 适合人在未知服务前逐步探索。通过 reflection 连接受控测试入口：
evans --host api.example.test --port 443 --tls repl服务未开放 reflection 时，从仓库契约启动：
evans --proto ./proto/order/v1/order.proto repl进入 REPL 后按 package、service、call 选择对象。提示符中的当前 package 和 service 是调用事实的一部分；截图若裁掉这段上下文，后续很难判断究竟调用了哪个同名方法。
先做只读正反调用
第一次探索选择无副作用方法，用假数据输入，并准备一个可预期失败：合法 ID 得到对象，不存在 ID 得到明确 NOT_FOUND，移除身份得到 UNAUTHENTICATED。三者应关联到同一测试环境和可查 request id。
Evans 会逐字段询问 message。嵌套结构、oneof、枚举和 repeated 字段必须对照当前 proto；仅凭提示完成输入不证明客户端和服务使用同一版本。遇到 UNIMPLEMENTED 时退出会话，核对全限定名、反射结果与部署，不在 REPL 中反复猜方法。
metadata 不应变成持久秘密
身份与租户 metadata 只注入临时测试值。命令历史、终端录屏、截图和配置文件都可能保存它们，分享材料只保留键名与脱敏主体。生产 token、真实用户标识和客户端私钥不能进入演示会话。
TLS、mTLS 和自定义 CA 由启动参数决定。若连接失败，先区分 DNS/TCP、TLS 握手、HTTP/2 入口和 gRPC status；不要用明文模式或跳过校验掩盖证书问题。代理或网关不支持端到端 gRPC 时，REPL 无法通过应用层设置补救。
流式 RPC 要主动收尾
Evans 的交互方式很适合观察 server stream 与双向流，但也容易留下无边界会话。开始前约定样本数量、最长时间和取消方式；结束后在服务端确认 stream 已关闭、goroutine/连接和下游订阅回落。mutation 或写入流必须使用隔离租户，并有恢复脚本。
Evans 不是 CI 运行器。确定故障形状后，把最小请求转成 grpcurl、正式 SDK 测试或契约测试资产。团队长期保留的是 proto 版本、目标、metadata 键、正反结果和清理记录，不是个人 REPL 历史。
升级前导出无秘密的测试说明，用固定服务双跑旧版和新版，检查 reflection、proto 解析、TLS、字段输入与 status 展示。停用时删除本地历史、临时 proto、证书副本和凭证，并从工具目录与团队文档移除入口。
官方资料：Evans 项目说明、gRPC reflection。