cmautobuy/docs/06-troubleshooting.md

generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件) wiki_page: Troubleshooting wiki_url: https://git.ilapage.cn/OPC/cmautobuy/wiki/Troubleshooting wiki_revision: 84518342612d53e2e3919c2f961b4f7eb5910ece synchronized_at: 2026-08-26T08:42:57Z

故障排查

排查顺序

1. 先保存完整错误时间、稳定错误码、任务号和操作步骤；凭据和个人数据脱敏。
2. 读取当前工单的状态、最新评论和首个未完成步骤，不重复已经验证的事实。
3. 确认错误属于 Admin、Client、Android 页面、MySQL、顺运宝、AI 服务还是 Wiki/Gitea。
4. 从最小只读检查开始：配置名称是否存在、进程是否运行、网络端口是否可达、数据状态是否符合前置条件。
5. 用代码知识图谱定位函数和调用链；错误文字、配置和脚本再用 rg。
6. 复现时优先独立测试库、脱敏固件和只读接口；不要用真实下单当普通诊断。
7. 找到根因后先更新工单，再按已确认范围修复并运行回归。

常见入口：

• Admin 启动/数据库错误：Admin 上手指南、质量安全、部署运维。
• Client 页面识别/规格选择：Client 架构、质量安全、脱敏 XML 固件。
• Client–Admin 404/422/幂等错误：Client API 契约。
• Wiki 镜像错误：检查在线页 revision、工作区脏文件和 wiki-docs.json 映射。

必须停止的情况

• 需要突破根 AGENTS.md 任一产品红线。
• 目标数据、环境或删除范围不明确。
• 工单、设计证据或用户确认缺失。
• 需要生产凭据但安全来源不可用。
• 采购任务已经进入不可逆阶段，却有人要求再次下单。
• 页面、规格、价格、数量、订单结果或候选不唯一。
• 数据库迁移自检不通过，或目标库可能不是测试库。
• Wiki 页面无法在线回读 revision，却准备把本地文件当成已同步。
• 工作区存在会被覆盖的无关修改。

停止时要把已确认事实、阻塞点、已尝试的安全检查和恢复条件写回工单。