示例成品 · 平台演示,按左边这组点选真跑出来的
示例:
【联调报错定位步骤卡】
报错类型:5xx服务端 | 环境:测试 | 状态码:502
一、总体判断
502通常说明网关到后端服务这一段没走通,优先查网关转发和服务存活,而不是先改业务代码。
二、排查顺序
第1层 网关
- 动作:确认网关是否拿到请求、有没有转发到后端。
- 看哪里:网关访问日志,按trace ID过滤。
- 复现:curl -v 'https://api.example.com/v1/order/query' -H 'X-Trace-Id: demo-trace-001'
第2层 服务
- 动作:确认服务进程在、端口通、日志里有没有异常栈。
- 看哪里:服务应用日志,搜trace ID和ERROR。
- 复现:在服务机器执行健康检查接口 curl 'http://127.0.0.1:8080/health'
第3层 数据库/缓存
- 动作:若服务已收到请求,检查连接池和慢查询。
- 看哪里:数据库慢日志、连接池监控。
- 复现:用同一请求体重放,观察耗时是否卡在DB。
三、交接话术
已确认网关转发到服务A,trace demo-trace-001在服务日志中无记录,请服务A检查端口和注册状态。
(以上为示意,实际结论以持证人员核对为准。)
点左边「开工 · 直接出成品」,出一份你自己的版本(文字免费)