问题排查 SOP 自检清单
💬 TDuckX 问题定位指引（Bug 检查步骤）
您好，为了更高效地协助您定位问题，请您先按照以下步骤进行自检，以便我们更准确地判断问题原因👇
为什么需要先进行问题自检
为了更高效、准确地定位系统问题，我们建议您在反馈前先进行一次 SOP 自检。 原因如下：
- TDuckX 系统由多个服务组成(前端、后端、缓存、数据库、定时任务等)， 很多问题可能由环境或缓存引起，而非系统本身 Bug。
- 不同客户环境差异较大（服务器配置、二开逻辑、第三方依赖等）， 自检能帮助我们快速判断是系统问题还是环境问题。
- 节省排查时间： 通过提供日志、操作路径和复现信息，我们能更快定位并给出解决方案，避免多次来回确认。
- 提高问题闭环效率： 自检能排除 70% 的非系统性问题，缩短从反馈到解决的周期。
简单来说，这个自检流程的目的是：
💡 让双方少沟通几轮，问题更快解决。
一、操作确认
- 请确认操作流程是否与官方指引一致。
- 建议清除浏览器缓存后重试。
- 使用推荐浏览器（Chrome / Edge 最新版）。
- 若方便，请在官方演示环境中尝试是否能复现。
二、基础环境排查
- Redis 与数据库服务是否运行正常。
- 缓存是否及时刷新（可重启或清空 Redis 测试）。
- 定时任务、消息队列是否在正常执行。
- 若使用了短信、Webhook 等第三方服务，请确认其状态正常。
三、代码版本一致性
- 当前版本是否与官方版本保持一致。
- 若进行了二次开发，请确认未改动统计、缓存等关键逻辑。
- 前端是否使用官方构建命令打包。
四、如何反馈问题
- 请查看
app.log或error.log是否有异常信息。 - 若问题可复现，请提供以下信息：
- 复现时间
- 操作路径 / 用户账号
- 问题截图或短视频
- 可同时查看接口返回状态码（200、500、504 等）。
五、初步判断建议
| 类型 | 判断依据 | 处理方向 |
|---|---|---|
| ✅ 系统 Bug | 官方版本可复现且日志异常 | 我们将进入修复流程 |
| ⚙️ 环境问题 | 不同环境表现不一致 | 建议排查服务器或配置 |
| 🧩 二开问题 | 修改后出现 | 建议恢复官方逻辑或自查改动 |
| 💡 操作问题 | 功能理解或操作不当 | 我们可提供操作指引 |
🔑 快速判断口诀
三问一看一比： 问环境 → 问代码 → 问复现路径 → 看日志 → 比官方版本