🛠️ 调试与排查手册

当系统出现问题时，不要慌张。本手册将引导您像专业工程师一样定位并解决问题。

🚑 快速诊断：你遇到了什么情况？

请根据您的即时感受，点击下方的链接跳转到对应章节：

1. 界面显示问题

症状：点击按钮没反应、页面一直在转圈、屏幕出现红色报错弹窗、白屏。
可能原因：前端代码报错、浏览器兼容性问题。
👉 解决方案：浏览器调试基础 (Browser Debugging)

2. 数据与通信问题

症状：提示 "Network Error"、列表数据为空、状态一直不更新、保存失败。
可能原因：网络中断、后端接口报错 (500)、接口地址错误 (404)。
👉 解决方案：接口与网络排查 (Network & API Debugging)

3. AI 任务与后端服务问题

症状：AI 生成的代码不对、任务并在“运行中”但没有日志、容器启动失败。
可能原因：Docker 容器挂了、后端服务崩溃、数据库连接失败。
👉 解决方案：后端日志与服务诊断 (Backend & Logs)

💡 调试黄金法则

复现问题：在这之前，先清空控制台日志。再次操作触发问题，捕获第一现场。
看报错信息：计算机通常很诚实，红色文字通常就是答案。
分层排查：按照 浏览器 -> 网络 -> 后端 -> 数据库 的顺序一层层找。