Table of Contents

故障排查

排查顺序
必须停止的情况

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

故障排查

排查顺序

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

常见入口：

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

必须停止的情况

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

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