11 常见问题与排查

本章整理上线后最常见的问题，并给出优先级最高的排查路径。

1. 前台无法注册 / 看不到"注册"按钮

原因：WordPress 未开启注册。

处理：后台 → 设置 → 常规 → 勾选 任何人都可以注册。

2. 注册提示"请输入邀请码"

原因：管理员开启了邀请码注册功能。

处理：

• 用户需要向管理员获取有效的邀请码。
• 管理员可在 主题设置 → 邀请码注册 中生成邀请码，或临时关闭邀请码功能。

3. 注册提示"该邮箱域名不允许注册"

原因：管理员开启了邮箱域名过滤，你使用的邮箱域名在黑名单中或不在白名单中。

处理：

• 用户：请使用常见正规邮箱（如 QQ、163、Gmail、Outlook 等）注册。
• 管理员：在 主题设置 → 全局设置 → 安全设置 → 邮箱域名过滤 中调整过滤规则。

4. 收不到邮箱验证码 / 找回密码邮件

优先排查：

1. 主题设置 → 全局设置：邮件总开关与"邮箱验证码"场景开关是否开启
2. 主题设置 → 验证码设置：邮箱验证码参数是否合理（有效期、重发间隔、每日上限）
3. 服务器发信能力：SMTP/端口/反垃圾策略

5. 支付弹窗没有任何支付方式

原因：后台未启用任何"可用通道"或服务商实例不完整。

处理：

1. 主题设置 → 支付配置
2. 确保至少一个服务商"启用"且参数填写完整
3. 在"支付通道"中启用至少一个通道
4. 保存后刷新前台再试

6. 用户支付成功但权限未生效

可能原因：

• 回调未到达（服务器防火墙/拦截/不支持外网访问）
• 金额不一致导致校验失败
• 服务商配置错误（密钥/订单号/签名）

建议流程：

1. 让用户先提交"支付反馈工单"（便于收集订单号/截图/支付时间）
2. 后台 订单列表 搜索订单号确认状态
3. 检查服务商回调配置与站点日志（如有）

7. 资源详情页提示"管理员尚未设置下载链接"

原因：文章使用 下载资源 或 下载 + 在线查看 资源获取方式，但未配置下载链接。

处理：编辑该文章 → 资源信息 → 下载信息 → 添加下载链接并更新文章。若该资源只需要在线查看，请把 资源获取方式 改为 在线查看。

8. 解压码不显示 / 显示不符合预期

排查：

• 文章是否勾选"使用全局密码"
• 全局设置是否配置了"全局解压密码"
• 若关闭全局密码，文章自定义解压密码是否为空

9. 用户中心 /user/ 打不开或跳回首页

原因：

• 用户未登录（主题默认未登录会重定向首页）
• /user/ 页面未创建或 slug 不一致

处理：

1. 确认已创建页面，且页面模板选择 用户中心
2. 建议页面固定链接为 user

提示：主题激活时会自动创建用户中心页面。如果页面被误删，手动重新创建即可。

10. 下载中转页提示"下载链接已失效"

原因：下载 Token 有时效性，超时后需要重新获取。

处理：返回文章详情页，重新点击"下载资源"获取新的下载链接。

11. 授权异常对网站的影响

主题授权采用"心跳 + 宽限期"机制：

• 网络异常等原因可能导致激活失败！

处理：

• 确保服务器可访问外网并开启 cURL
• 在 主题设置 → 主题授权 中重新授权/检测更新

12. 仍无法解决？建议提供的信息

为了更快定位问题，建议你准备：

• 站点域名与问题复现步骤
• 相关页面链接（资源详情页、VIP 页等）
• 后台截图（支付通道配置/验证码配置/全局开关）
• 服务器环境：PHP 版本、WordPress 版本、是否启用缓存/CDN