适合什么场景
适合主站页面异常、在线工具结果不对、小程序接口失败、LiteMall 链路异常、Java 后端报错、服务器部署问题和客户反馈。
关键是先复现和定级，再修复。不能在事实不足时直接改代码，也不能把本地修复当成线上已恢复。
Issue Triage
问题排查模板
线上问题不能只写“有 bug”。先把现象、环境、复现路径、影响范围、排查记录、修复方案、回归验证和发布交接写清楚，再交给 AI 或开发者处理。
问题单预览
复制后把空白项填成具体页面、接口、环境、复现步骤、日志、修复文件和回归结果。
# 问题排查记录 ## 1. 问题身份 - 问题标题： - 产品类型：主站 / 在线工具 / 小程序 / LiteMall / Java 后端 / 服务器部署 / 其他 - 发现人或来源： - 首次发现时间： - 关联发布记录或提交号： ## 2. 现象和预期 - 实际现象： - 预期结果： - 报错信息或截图： - 页面、接口或功能入口： - 是否影响生产用户： ## 3. 环境和上下文 - 环境：本地 / 预发 / 生产 / 微信开发者工具 / 真机 - 设备、系统、浏览器或微信版本： - 账号状态或权限角色： - 相关配置、域名、环境变量名称： - 最近相关变更： ## 4. 复现步骤 - 步骤 1： - 步骤 2： - 步骤 3： - 输入数据或测试账号类型： - 复现结论：必现 / 偶现 / 未复现 / 仅生产 / 仅移动端 ## 5. 影响和优先级 - 影响范围： - 优先级：阻断 / 高 / 中 / 低 - 是否影响数据写入或支付： - 是否需要回滚或临时关闭入口： - 用户侧绕行方案： ## 6. 排查记录 - 已检查日志、接口、页面或数据： - 可能根因： - 已排除原因： - 需要用户提供的资料或权限： - 最终根因： ## 7. 修复方案 - 修复目标： - 修复文件、接口或配置： - 暂不处理范围： - 数据修复或配置调整： - 回滚方式： ## 8. 回归验证 - 原复现路径验证： - 正常路径验证： - 边界或异常路径验证： - 运行命令： - 移动端、线上或第三方平台复查： ## 9. 发布和交接 - 提交号： - 发布状态：未部署 / 已部署 / 线上已复查 / 等待用户动作 - 发布记录： - 残留风险和预防动作： - 下一位 AI 接手时先读： ## 10. 质量检查 - 问题单必须能复现或说明为什么暂时不能复现。 - 实际现象、预期结果、环境和最近变更不能缺失。 - 修复范围要小，不能把无关重构、随机工具或公开报价页混进缺陷修复。 - 回归验证要覆盖原问题路径和至少一个正常路径。 - 如果没有部署或线上复查，发布状态必须明确写成等待动作或待复查。 ## 11. 停止规则 - 涉及生产数据库、支付、账号权限或服务器配置时，没有备份和回滚方案不能直接修。 - 无法复现且没有日志、截图或可验证线索时，先补事实，不直接猜代码。 - 不能把密钥、Token、后台账号、真实订单、手机号、地址或支付数据写进公开仓库。 - 线上紧急阻断问题应优先回滚或关闭入口，再做根因修复。 - 用户控制台、微信平台、Vercel 或服务器权限缺失时，必须记录阻塞，不伪装成已完成。
排查闭环
每个问题都按这个顺序收口，避免只靠聊天记忆判断“应该修好了”。
第 1 步
收集问题事实
先记录谁遇到、在哪个环境、哪个页面或接口、发生了什么，不直接猜原因。
问题入口、用户角色、设备、浏览器、账号状态和时间点。
报错截图、控制台日志、接口响应、服务器日志或用户描述。
最近一次相关发布记录、提交号和部署状态。
第 2 步
复现最小路径
把问题压缩成可重复步骤，区分必现、偶现、仅生产、仅移动端或仅某个账号。
复现步骤、输入数据、预期结果和实际结果。
本地、预发、生产分别能否复现。
不能复现时记录已尝试路径和缺失条件。
第 3 步
定级影响面
判断是否阻断核心流程、是否影响生产数据、是否需要回滚或暂停发布。
影响用户范围、业务流程、数据读写和安全边界。
优先级：阻断 / 高 / 中 / 低。
是否需要先执行回滚、禁用入口、公告或用户侧绕行。
第 4 步
定位根因
从最近变更、日志、数据、接口、环境变量和第三方依赖中排查根因。
可能根因和已排除原因。
对应文件、接口、配置、数据库记录或部署变更。
需要用户提供权限、日志、截图或控制台操作时单独列出。
第 5 步
实施修复
优先做最小安全修复，并明确不在本次顺手扩大范围。
修复文件、变更原因和风险控制。
是否需要数据修复、缓存刷新、重新部署或配置回滚。
没有引入随机功能、公开报价页、密钥或生产数据。
第 6 步
回归验证
修完后复跑原复现路径，并补正常路径、边界路径和受影响页面检查。
原问题复现路径已变为通过。
相关正常流程、边界输入、移动端和构建测试结果。
未覆盖风险、仍需人工复核或外部平台验证的事项。
第 7 步
发布和交接
修复后把部署状态、线上复查、回滚方式和后续预防动作写入发布记录和 HANDOFF。
提交号、发布记录、线上检查结果和回滚方式。
是否需要补单测、监控、日志、告警或用户说明。
下一位 AI 接手时应先读的问题单、发布记录和相关 Runbook。
模板字段
字段越具体，后续 AI 越能直接复现、定位和验证，而不是重新追问。
1. 问题身份
问题标题：
产品类型：主站 / 在线工具 / 小程序 / LiteMall / Java 后端 / 服务器部署 / 其他
发现人或来源：
首次发现时间：
关联发布记录或提交号：
2. 现象和预期
实际现象：
预期结果：
报错信息或截图：
页面、接口或功能入口：
是否影响生产用户：
3. 环境和上下文
环境：本地 / 预发 / 生产 / 微信开发者工具 / 真机
设备、系统、浏览器或微信版本：
账号状态或权限角色：
相关配置、域名、环境变量名称：
最近相关变更：
4. 复现步骤
步骤 1：
步骤 2：
步骤 3：
输入数据或测试账号类型：
复现结论：必现 / 偶现 / 未复现 / 仅生产 / 仅移动端
5. 影响和优先级
影响范围：
优先级：阻断 / 高 / 中 / 低
是否影响数据写入或支付：
是否需要回滚或临时关闭入口：
用户侧绕行方案：
6. 排查记录
已检查日志、接口、页面或数据：
可能根因：
已排除原因：
需要用户提供的资料或权限：
最终根因：
7. 修复方案
修复目标：
修复文件、接口或配置：
暂不处理范围：
数据修复或配置调整：
回滚方式：
8. 回归验证
原复现路径验证：
正常路径验证：
边界或异常路径验证：
运行命令：
移动端、线上或第三方平台复查：
9. 发布和交接
提交号：
发布状态：未部署 / 已部署 / 线上已复查 / 等待用户动作
发布记录：
残留风险和预防动作：
下一位 AI 接手时先读：
质量检查
问题单必须能复现或说明为什么暂时不能复现。
实际现象、预期结果、环境和最近变更不能缺失。
修复范围要小，不能把无关重构、随机工具或公开报价页混进缺陷修复。
回归验证要覆盖原问题路径和至少一个正常路径。
如果没有部署或线上复查，发布状态必须明确写成等待动作或待复查。
