先确认问题发生在哪一步
先记下文章、资源名称、当前账号和完整提示，再按下面的顺序排查：下载区不显示、提示登录或购买、点击下载失败、已经打开外部地址但文件不可用。
设置入口是 WordPress 文章编辑页的「＜瓜奇＞文章功能 → 下载」。检查前先确认文章已经发布，并且查看的是同一站点、同一语言的文章。
下载区完全不显示
- 打开目标文章的下载设置，确认「是否开启下载」已打开。
- 检查「下载列表」中至少有一项资源，且需要的下载链接已填写。
- 保存后重新打开后台，确认配置没有丢失。
- 检查当前文章详情模板是否配置了下载模块，以及模块是否有显示条件。
- 重新打开文章页面，确认页面已取得最新配置。
「列表中显示为：下载」不能代替下载开关或文章详情页中的下载模块。
资源可见，但提示登录或购买
进入「下载列表 → 对应资源 → 下载权限」，核对当前账号的用户组、普通等级和 VIP 有效状态。能阅读正文，不代表有下载权限；「推广权限」也不能用来解锁下载。
已购买用户还要核对购买身份、文章、具体资源和订单是否完成。若购买后调整过资源或权限行的顺序，也应检查是否影响了订单匹配。游客购买应使用原购买时的身份环境排查，不要让客户先再买一次。
管理员能下载，不能证明普通用户也能下载。请使用实际受影响的普通账号检查权限和每日额度。
点击下载后报错
| 错误码或现象 | 含义 | 处理方法 |
|---|---|---|
RESOURCE_NOT_FOUND |
文章不存在、未发布，或没有可读取的资源配置。 | 核对文章 ID、发布状态，以及下载设置是否保存。 |
RESOURCE_DOWNLOAD_FORBIDDEN |
选中的资源不存在于当前可用列表中，或未获得下载权限。 | 先检查下载开关和资源列表，再核对权限及购买记录。不能只据此认定用户等级不足。 |
RESOURCE_DOWNLOAD_URL_NOT_FOUND |
选中的下载地址不存在或为空。 | 打开该资源的下载链接，检查具体地址；修改过地址顺序后，重新加载页面再试。 |
DAILY_DOWNLOAD_LIMIT_REACHED |
当天领取下载地址的次数已达到等级上限。 | 核对当前普通等级或有效 VIP 的「每日下载次数上限」，等待下一天或按站点规则调整额度。 |
DOWNLOAD_QUOTA_NOT_INITIALIZED |
额度记录的数据库操作失败，可能涉及初始化或数据库异常。 | 让维护人员检查初始化状态和数据库错误。不要只凭错误码就反复执行初始化。 |
RESOURCE_DOWNLOAD_UNAVAILABLE 或通用失败提示 |
前台未取得符合预期的下载响应，或请求失败。 | 记录发生时间和操作步骤，请维护人员检查请求响应；不能直接判定为购买失败。 |
提示每日下载次数用完
每日额度按用户和前端范围记录。有效 VIP 的额度配置优先于普通等级；上限为 0 时不限制。游客和具有后台管理权限的账号不走普通额度扣减。
次数在成功申请下载地址时消耗，重复领取同一资源也会计次。它不按文件大小计算，也不等待文件下载完成。下一天按网站时区计算，不能直接按访客设备上的时间判断。
已经购买资源的普通用户仍可能受额度限制。不要用反复点击下载按钮的方法检查网盘故障。
已经打开网盘或文件地址，但下载失败
成功取得地址，说明这次网站内的下载申请已经通过。接下来检查外部文件是否被删除、分享是否过期、网盘是否要求登录，以及提取码和解压码是否正确。
外部下载失败不会在这条申请流程中自动返还次数。若没有打开新窗口，也检查浏览器是否拦截了弹窗。
修复后先直接验证外部地址，再用受影响的账号重新申请一次，确认网站授权和外部下载都正常。
其他语言版本下载不了
核对当前站点、页面语言和实际文章 ID，再检查目标文章是否发布、资源是否存在、地址和权限是否正确。不能仅凭源文章可下载，就判断译文也已配置完成。
原语言的购买记录不应直接视为另一篇文章的购买记录。排查时保留资源和权限行的现有顺序，先确认订单对应的对象。
相关教程：01.01.020 选择目标前端与区分全局配置；01.02.010 设置全局语言池与前端启用语言；03.08.010 复制文章到其他语言并检查关联内容；03.08.030 批量翻译文章并处理已有译文。
仍未解决时提供这些信息
向维护人员提供文章链接或 ID、资源名称、点击的按钮、站点、语言、发生时间、账号身份、是否已购买和完整错误文字。已购问题再提供必要的订单标识。
不要在公开反馈中发送登录凭据、支付密钥、用户隐私或受限文件的完整地址；日志应先脱敏。