故障排查

先按「现象 → 先检查 → 再处理」的顺序来。不要一上来就改配置或重装环境，很多问题刷新或换浏览器就能排除。

页面打不开 / 白屏

先检查	处理
换一个浏览器或隐身窗口	排除缓存、插件、Cookie 问题
用手机流量打开	排除公司网络或代理拦截
打开浏览器控制台，看是否有红色报错	截图报错，交给实施人员
访问其他页面是否正常	只有单页异常，通常是该页数据或资源问题
演示站还是自己的环境	演示站问题联系官方；自有环境按交付文档检查

白屏且控制台有「找不到模块」「重复声明」一类报错，通常是构建产物不完整，需要重新构建并完整上传，而不是只补一个文件。

登录后立刻退出 / 反复跳登录

1. 确认浏览器允许 Cookie，且没有开启「退出后清除站点数据」。
2. 确认系统时间准确；时间偏差会导致登录票据失效。
3. 检查是否同时开了多个环境（测试/正式）的同一域名。
4. 清除站点缓存后再登录。
5. 仍失败时，记录账号、时间和浏览器版本，交给支持人员查日志。

支付成功但订单未更新

1. 在支付渠道后台确认是否真的扣款成功。
2. 核对商户号、订单号、金额是否一致。
3. 检查支付回调地址是否可公网访问、是否被防火墙拦截。
4. 检查支付密钥是否与当前环境一致。
5. 不要手动把订单改成已支付；先保留流水号，交给实施人员处理回调。

退款失败

原因	处理
原支付单号不存在	核对订单与支付流水是否对应
商户余额不足	充值或换退款方式（按渠道规则）
超过可退款期限	按渠道规则处理，必要时线下退款并留记录
重复退款	查退款记录，避免重复提交

图片不显示 / 样式错乱

1. 强制刷新（Ctrl/Cmd + Shift + R）。
2. 检查图片地址是否能直接打开；404 说明资源未上传或路径错误。
3. 检查是否只上传了 HTML，没有上传静态资源目录。
4. 检查 CDN 缓存；刚替换的图片可能需要刷新缓存。
5. 多端项目检查构建时的资源前缀是否与部署子目录一致。

后台看不到菜单 / 没有权限

1. 确认当前账号的角色。
2. 确认账号绑定的门店、商户或平台是否正确。
3. 让管理员检查角色授权和权限点。
4. 不要用超级管理员账号长期日常操作；给每个岗位单独建角色。

小程序打不开 / 无法登录

1. 确认小程序后台的业务域名已加入 qishujia.com 或你的正式域名。
2. 确认 HTTPS 证书有效。
3. 确认小程序 AppID 与当前构建一致。
4. 微信内打开 Web 页面时，检查是否需要业务域名校验文件。
5. 开发版/体验版与正式版的配置可能不同，分别检查。

数据不同步 / 金额对不上

1. 先确认筛选条件（门店、商户、时间范围、订单状态）。
2. 导出订单号、支付流水号、退款单号。
3. 对比订单实付、退款、优惠券、积分和佣金。
4. 涉及多商户时，确认订单归属和结算规则。
5. 不要直接改数据库；把差异清单交给支持人员。

演示站问题

演示站是静态交互演示，部分按钮只做展示。遇到：

• 按钮无反应：先确认是否是纯展示按钮。
• 数据重置：演示数据可能定期恢复，属于正常现象。
• 页面 404：确认地址是否为 https://qishujia.com/demos/<产品 id>/。

还是解决不了

按 联系支持 的报障模板发邮件，附页面地址、操作步骤、截图和发生时间。