FAQ：活动打不开或白屏
先看玩家屏幕上的提示文字分流：有明确提示（未开始/已结束/无权限）= 配置问题，商家自查即可；无提示纯白屏或卡加载 = 反馈客服并附活动链接与手机型号。
按提示分流
| 玩家看到 | 原因 | 商家怎么办 |
|---|---|---|
| 活动未开始（倒计时页） | 未到开始时间（以服务器时间为准，玩家改手机时间无效） | 确认"发布时间"模块的开始时间 |
| 活动已结束 | 已过结束时间或被手动结束 | 需要继续跑就延长结束时间（未手动结束的情况下） |
| 活动已暂停 | 商家点了暂停 | 顶栏"恢复" |
| 无权限/不在名单内 | 访问控制开了白名单模式 | 检查"访问控制"名单与模式 |
| 请在微信中打开 / 授权页 | 活动要求微信授权/关注 | 属正常门槛；确认公众号已授权 |
| 提示登录/身份验证 | 开了会员身份验证（高级会员对接场景） | 确认从正确入口（自有APP/商场小程序）进入 |
无提示类问题
一直停在加载画面
- 玩家侧：换网络重进一次；
- 商家侧：检查是否替换过素材图后未保存成功（缺图可能导致加载卡住）；预览正常但线上异常时，反馈客服（附活动 ID）。
纯白屏
多为个别机型/网络下的资源加载异常或历史模板缺陷，平台已对主力模板做了防御性兜底。反馈客服时请附：活动链接、出现时间、手机型号与微信版本、是否稳定复现。
从分享卡片进来的人打不开，直接进的人正常
检查分享配置是否完整；助力类活动请让玩家从新生成的分享链接进入（旧链接可能带失效参数）。
客服/技术排查线索（内部）
- 玩家进入/游玩层（PHP）错误码是复用且随接口变义的，只有两个可靠：
99=未登录/no auth（缺玩家 JWT，常见于绕过入口直开游戏壳 URL）、-9=风控拦截（黑名单或 IP/openid 风控）。-3/-4为活动状态/时序类错误（未开始/已结束/找不到活动/频控等，含义随接口而定），务必结合返回 msg 判断，不要按数字断言原因。 - 白屏类历史根因：模板异步渲染链缺 try/catch（后端字段形状变化即抛错）、加载页在同步异常时不隐藏——均已加看门狗/兜底，新报障按模板逐个确认版本。
- 预览白/循环跳登录：预览走固定测试玩家 JWT；若过期自动重签，仍异常刷新编辑器。