主题
出问题了怎么办
一句话
按症状找。先确认是不是缓存，那是最常见的原因。
⭐ 先做这三件事
80% 的"bug"在这里就解决了
- 强制刷新 —— Windows
Ctrl+F5，MacCmd+Shift+R - 换无痕窗口打开 —— 排除浏览器缓存和插件
- 等 1 分钟再看 —— 前台页面有缓存，改完不是瞬间生效
前台相关
改了后台，前台没变
| 改的是什么 | 生效时间 |
|---|---|
| 站点设置（名称/logo/颜色） | 约 4 秒 |
| 商品 | 保存即触发，约 10 秒内 |
| 首页装修 / 横幅 / 单页 | 保存即触发 |
| 界面文案 | 约 4 秒 |
还是没变
- 强制刷新
- 无痕窗口
- 确认保存成功了（有没有报错提示）
- 都不行 → 找技术
图片裂了 / 不显示
按这个顺序查
- 后台的图片空间里能看到那张图吗
- 直接在浏览器打开图片地址，能打开吗
- 商品/横幅里那张图是不是被删过
商品页 404
- 商品是上架状态吗
- slug 改过吗（改了老链接就失效）
首页是空的 / 店铺名变成 "Mall"
这通常是部署时后端没起来
找技术。不要自己去后台改店铺名 —— 名字本来就是对的， 是前台取不到配置退回了默认值。
下单相关
买家说下不了单
最常见的是运费
运费模板没覆盖他的国家 = 不可送达 = 下不了单（这是有意的）。
去 订单管理 → 运费模板，确认他的国家在里面。
其他可能：
- 库存不足（可用库存是 0）
- 商品下架了但他的购物车里还有
- 优惠券过期/名额用完（让他先移除优惠码试试）
买家付了钱，订单还是待付款
先等 5 分钟
支付回调偶尔会晚。系统还有主动查单补偿，通常自己会好。
超过 30 分钟还没变
- 去支付平台后台搜这笔（用买家的邮箱或金额）
- 平台显示成功但订单没变 → 找技术，不要手工改订单状态
- 平台也没有 → 让买家提供付款截图/扣款记录
支付页打不开 / 点了没反应
- 支付通道是启用状态吗
- 密钥填对了吗（沙箱密钥在正式环境是不通的）
- 让买家换个浏览器/关掉广告拦截插件试试
邮件相关
买家收不到验证码 / 订单确认
先看手机有没有收到 Bark 告警
发信失败时系统会持续推送（配了 Bark 的话）， 推送里直接写了原因和该做什么 —— 比下面这套排查快得多。
按顺序查
- 发信服务配了吗（站点设置 → 联系与法务）
- 后台发一封测试邮件给自己，收得到吗
- 收不到 → API Key 或发件地址有问题
- 收得到但买家收不到 → 让他看垃圾箱
- 今天的发信配额用完了吗（群发会吃配额）
邮件进垃圾箱
- DKIM / SPF / DMARC 都配了吗
- 之前有没有发给过没订阅的人（域名信誉被扣）
- 主题行像不像广告
后台相关
登不进去
- 密码错了 —— 连续错会被临时锁，等一会儿
- 页面能打开但一直转圈 → 强制刷新
- 页面完全打不开 → 服务挂了，找技术
某个页面报 401 / 没权限
角色里没勾那个菜单。改完让他重新登录。
新建的表单里带着上一条的内容
在标签栏关掉那个标签再重新打开。
服务器相关
服务器重启了 / 停过电
不用做任何事。 所有服务都设了开机自启，机器一开机就自己回来。
等 1~2 分钟再刷新（后端要等 MySQL 就绪，前端要等后端就绪）。
想确认自启这一项配好了
bash
python deploy.py check里面会逐个查 7 个服务的开机自启状态。
网站打不开（502 / 白屏），刚重启过
等 1~2 分钟。还不行：
bash
python deploy.py status会告诉你哪个服务没起来。
网站打不开，也没重启过
bash
python deploy.py status
python deploy.py logs backend看不懂就把输出发给技术。别在这时候做删数据、改配置这类操作。
数据相关
报表数字和订单列表对不上
口径不同，正常
- 报表只算已付款及之后
- 报表的"今天"按站点时区切
- 沙箱订单也算在里面
仪表盘今天 0 单，但订单列表有单
时区。去 站点设置 → 本地化 确认。
平台的转化数和订单数对不上
永远不会一样，见 转化与归因。
什么时候该找技术
这几种情况自己别碰
- 网站完全打不开（502 / 白屏）
- 后台完全登不进去
- 订单状态和支付平台不一致
- 数据看起来被删了
- 收到"数据库"、"迁移"、"启动失败"之类的报错
说清楚：什么时候开始的、你做了什么操作、报错的原文/截图、 有没有其他人也遇到。这三件事能省掉一半排查时间。