03.02.040 排查下载入口不显示或无法下载

一、这个功能能做什么

先确定问题发生在哪一步：没有下载模块、没有访问权限、点击后提示失败，还是已经跳转到外部地址后失败。不同阶段的处理方式不同。

可以按“没有下载区”“需要购买”“点击后报错”“网盘打不开”分别排查，判断问题发生在网站设置、权限还是外部资源。

遇到下载错误时，可以按下表排查。页面也可能只显示通用权限提示；仅凭“没有权限”无法判断是否为用户等级不足。

按顺序检查：

「列表中显示为：下载」主要用于列表展示，不能代替下载开关或详情模块。

后端错误码／提示	已确认的含义	下一步
`RESOURCE_NOT_FOUND`：资源不存在或尚未发布／未找到可下载资源	文章不存在、未发布，或没有可读取的资源配置	检查文章状态、文章是否正确及资源配置是否保存
`RESOURCE_DOWNLOAD_FORBIDDEN`：当前账号无权下载此资源	没有取得允许下载的资源项；关闭下载、资源列表变化或权限不满足都可能进入此分支	先核对开关和资源是否存在，再查用户组、购买和权限行
`RESOURCE_DOWNLOAD_URL_NOT_FOUND`：该下载地址不存在	选中的地址不存在或地址为空	检查具体资源下的下载链接，尤其是编辑删除或调整地址之后
`DAILY_DOWNLOAD_LIMIT_REACHED`：今日下载次数已达上限	当前用户当天取得下载地址的次数达到所用等级上限	查看普通等级或有效 VIP 的额度及网站时区；不要反复点击
`DOWNLOAD_QUOTA_NOT_INITIALIZED`：下载额度数据尚未初始化	额度数据的数据库操作失败，可能是未初始化，也可能是数据库异常	请站点维护人员确认初始化状态和数据库错误；不能仅凭此提示认定缺表或反复执行初始化
只有通用的无权限或失败提示	页面也会在请求失败、未收到有效结果等情况下显示通用提示	保留发生时间和操作步骤，交由维护人员结合响应及脱敏日志确认

如果提示不在表中，请记录完整错误、发生时间和文章地址，联系站点维护人员排查。

提供文章链接或 ID、出问题的资源名称和按钮、前端站点、页面语言、发生时间、客户身份类型、是否已购买，以及完整可见错误文字。涉及已购问题时提供必要的订单标识，通过适当的支持渠道处理。

不要公开发送登录凭据、支付密钥、用户隐私信息或受限文件的完整下载地址。维护人员如需日志，应先脱敏。

先确认当前前端、页面语言和实际内容 ID。复制到其他语言产生独立目标记录，复制完成不代表已经发布，也不代表所有资源字段和手动链接已翻译。目标分类应符合该前端的范围。

下载资源复制后，应检查目标记录的地址、权限与价格。订单匹配涉及文章 ID 和资源／权限行索引，不能承诺原文购买记录自动通用于译文；也不应随意重排已有付费资源。

先确认客户当前身份、等级、VIP 有效状态，再查看该资源的每条下载权限。阅读权限、推广权限和下载权限用途不同；客户能看正文不说明能下载。

如果客户已购买，核对同一文章、同一资源、已完成订单以及购买身份。还要确认资源和权限行是否被删除或重排。游客购买应核对原游客会话，不要求客户先再买一次。

如果管理员能下载、普通用户不能，仍需用普通账号检查用户权限和每日额度；管理员账号会跳过普通每日额度限制。

能成功取得地址，说明该次下载申请已经通过；外部地址可用性要单独检查：文件是否仍存在、分享是否过期、网盘是否要求登录、提取码和解压码是否匹配。

每日次数在取得地址时扣除。外部文件下载失败，这条流程不会自动退回额度。避免用反复点击同一个下载按钮来测试外部文件。

如果没有弹出新窗口，也检查浏览器是否阻止了窗口打开；不要因此改成所有用户免费。

当前每日额度按领取下载地址计数，重复领取同一资源也计入；外部网盘或文件下载失败不自动退还这次领取。管理员和游客等有特定豁免，不能用管理员验证普通用户额度。