常见问题

排查前请先确认：主题授权是否正常、当前账号是否已登录、对应后台开关是否启用，以及缓存或 CDN 是否仍在返回过期页面。

注册

未显示注册入口，或点击无响应

WordPress 未开放注册。请进入 设置 → 常规，勾选「任何人都可以注册」。

若仍无法注册，请继续检查验证码、邀请码、邮箱域名过滤，以及安全插件是否拦截主题接口。

提示需要邀请码

站点已启用 主题设置 → 邀请码注册。请向用户提供仍有效、次数未用尽且未过期的邀请码，或临时关闭邀请码注册。已使用的邀请码不可删除，仅可停用。

提示邮箱域名不允许

命中了 全局设置 → 安全设置 → 邮箱域名过滤。白名单模式下，用户邮箱后缀必须在名单内；黑名单则相反。请仅填写 gmail.com 等后缀，勿填写完整邮箱地址。

未收到邮箱验证码或找回密码邮件

请按以下顺序检查：

  1. 全局设置 → 邮件控制：总开关与验证码邮件是否启用
  2. 验证码设置：注册 / 找回密码场景是否实际使用邮箱验证码
  3. 服务器 SMTP、端口、授权码与发信域名
  4. 用户邮箱垃圾箱、拦截规则，以及每日发送上限

全局验证模式不可设置为邮箱验证码。邮箱验证码仅适用于注册、找回密码与修改邮箱。登录、修改密码与反馈须使用图形验证码或第三方验证。

验证码显示异常或持续报错

请在 验证码设置 中核对：当前场景是否启用、密钥是否完整、页面是否被缓存为过期状态。若启用了整页缓存，请打开 全局设置 → 缓存 中的「页面缓存兼容」。

仅某一页面异常时，优先检查该页是否缓存了过期校验凭证。国内访问 Google reCAPTCHA 不稳定时，请改用图形验证码或腾讯验证码。

支付

支付弹窗未显示任何支付方式

支付配置 中须至少有一个参数完整的服务商，以及一条已启用的支付通道。保存后请刷新资源详情页或 VIP 页面，并清除缓存后再次核验。

用户已付款，订单仍为待支付

异步通知未到达站点，或到达后未通过校验。请核对：

  1. 服务商后台的通知地址是否与主题示例一致
  2. 商户号、密钥与金额是否匹配
  3. CDN、防火墙或安全插件是否拦截 /payment/
  4. 支付日志中对应时间点的记录

请引导用户提交支付反馈，并附上订单号、付款凭证与支付时间。

款项已入账，资源或会员未生效

订单可能处于「已收款，权益发放失败」。请在 订单列表 中搜索订单号。

资源订单：确认文章仍为资源商品，下载链接或在线图库是否完整。交付不完整的资源将停售。

VIP 订单：确认套餐仍然存在且已启用，升级规则未在付款过程中被修改。可在 VIP 会员 → VIP 用户 中核对并手动补发。

请勿要求用户对同一笔履约失败订单重复支付。

资源与 VIP

详情页提示未设置下载链接

获取方式已选择「下载」或「下载 + 在线查看」，但「下载信息」为空。请至少添加一条下载链接。若仅提供在线阅读，请将获取方式改为「在线查看」，并确保正文包含商品图库。

在线查看仅显示少量图片

常见原因：用户尚未获得权限，仅能看到免费预览（最多 8 张，亦可为 0 张）；正文可提取的商品图不足；外链图片被防盗链拦截；图片位于文字之后，未进入图库。

请将商品图放入 WordPress 图库区块（或 [gallery]），使用已购买或有效 VIP 账号核验完整阅读器，并检查浏览器是否出现图片 403 / 404。

仅会员资源提示额度不足

对应 VIP 等级设置了每日获取上限，且当天额度已用尽。0 表示不限次数。下载与在线查看计为同一次获取；同一自然日内重复打开同一篇文章通常不再扣减。

解压密码未显示或不正确

请确认文章是否勾选「使用全局密码」，以及 全局设置 中是否填写全局解压密码。自定义密码为空时，前台不显示密码区域。用户须先获得权限方可查看。

下载页提示链接失效

下载凭证具有时效。请返回文章详情页重新生成。若频繁失效，请检查服务器时间是否准确、缓存是否保存了过期链接，以及用户是否更换浏览器或账号访问。

页面与外观

用户中心无法打开或返回首页

页面被删除、模板未选择「用户中心」，或固定链接别名不是 user。请新建页面，选择「用户中心」模板，并将别名设为 user。未登录访问时将被引导登录，此为预期行为。

VIP、排行榜、标签云、Coser 与解压帮助页的处理方式相同，请对照 安装与上线 中的模板表重建。

首页修改后前台未更新

请确认首页编辑器已执行「发布」。草稿不会上线。随后清除主题缓存、页面缓存、CDN 与浏览器缓存，并检查 设置 → 阅读 是否将首页指定为固定页面。模块无内容时，请先确认文章、标签、Coser 或 VIP 数据本身存在。

Logo、配色或网站图标未更新

在首页编辑器中修改外观必须执行「发布」。网站图标仍在 外观配置 中管理。浏览器对图标的缓存周期较长，可更换文件名或等待缓存过期。透明导航导致文字对比不足时，请改用「固定吸顶」，或降低首屏背景亮度。

维护模式被误启用时，管理员登录后进入 外观配置 → 高级功能 即可关闭。

图片模糊范围不符合预期

请核对全局模糊开关、作用范围、可见条件、作用位置，以及文章是否单独强制开启或关闭。文章级设置优先于全局规则。已登录用户与已获得资源权限的用户并非同一可见条件。

授权

授权异常时，前台可能出现提示或 503，后台「主题设置」被重定向至授权页，支付、下载与注册接口不可用，更新检测亦将停止。

请进入 主题设置 → 主题授权，核对授权码、域名、外网访问与 cURL 状态，再重新检测或重新授权。

提交支持请求时请提供

  • 站点域名与出现问题的页面链接
  • 复现步骤
  • 用户 ID 或订单号
  • 支付服务商名称与第三方交易号
  • 相关后台截图
  • PHP 版本、WordPress 版本与主题版本（可在 外观 → 主题 或授权页查看）
  • 是否启用缓存、CDN、安全插件或防火墙
  • 近期是否修改过支付、VIP、验证码、缓存、授权或固定链接设置

另请参阅