用途：面向后端服务的结构化调试流程，覆盖 API 报错（4xx、5xx）、性能退化或慢查询、服务无法启动或崩溃、服务间数据不一致、发布后故障，以及用户反馈“某功能坏了”等场景。
主要流程与能力：
- 收集症状：先不改代码，明确坏了什么、何时开始、影响谁、错误信息（日志、HTTP 响应、堆栈）。
- 检查明显项：查看最近提交记录 git log --oneline -10、服务健康 curl -s http://localhost:8080/health | jq .、日志错误 grep -i "error|exception|fatal" logs/app.log | tail -20、数据库连通 psql -h $DB_HOST -U $DB_USER -d $DB_NAME -c "SELECT 1"、环境变量 env | grep -i "DB_|API_|SECRET_" | sort。
- 缩小范围：按症状分流，如 500 查堆栈、404 查路由注册、401/403 查鉴权配置、慢响应查 EXPLAIN、超时查下游服务、数据缺失查软删除、无法启动查 Bean 装配。
- 复现：尝试本地触发、找最小失败请求、判断稳定复现还是偶发。
- 找根因：回归问题可用 git bisect start、git bisect bad HEAD、git bisect good <last-known-good-commit>；用 grep 定位错误信息与调用方。
- 修复与验证：先写复现失败测试，再修复，跑全量测试，面向用户的功能需手工验证。
限制与注意：资料未提供具体语言框架、版本或收费信息；未提供 common-issues.md 内容。避免只治标、先看部署日志、注意环境差异、偶发多与竞态相关、不要一上来就重启服务、查询需带 deleted_at IS NULL，修复前需理解根因并记录影响用户的事故。