在使用安企CMS进行网站内容管理和开发时，我们经常会通过API接口获取各种数据，其中获取文档详情 (/api/archive/detail) 是非常常用的一个。当您在调用这个接口时，如果遇到系统返回错误码1001或1002，这通常表明请求未能成功处理，并给出了具体原因。理解这些错误码的含义及其解决方法，能够帮助我们更高效地排查问题，确保网站内容的正常展示。

错误码1001：未登录

当您尝试获取文档详情时，如果系统返回错误码1001，这明确表示您的当前会话没有通过安企CMS的用户身份验证。简单来说，就是系统不认识您是谁，或者您没有告诉系统您是谁。

常见原因分析：

  1. 尚未登录： 您可能还没有进行用户登录操作，或者在前端页面/客户端应用中，用户的登录状态已经失效。
  2. 会话过期： 用户之前登录过，但由于长时间未操作或其他安全策略，登录会话（例如存储的Token）已经过期，需要重新获取。
  3. 内容受限： 您正在尝试访问的文档详情被设置为了“仅登录用户可见”，而您当前的请求并没有携带有效的登录凭证。

解决方法： 最直接的解决办法就是进行用户登录。安企CMS提供了登录接口（通常是/api/login），通过该接口成功登录后，系统会返回一个用户凭证（通常是Token）。您需要确保在后续的API请求中，将这个Token正确地附加到请求头（例如Authorization字段）或作为请求参数发送。对于前端应用，这意味着您需要实现登录流程，并在用户登录后将获取到的Token妥善存储（如LocalStorage或Cookie），以便在每次请求需要认证的接口时携带。如果Token过期，则需要引导用户重新登录以获取新的Token。

错误码1002：未授权

与1001不同，错误码1002意味着您虽然已经登录，系统也识别了您的身份，但您的账户没有足够的权限来访问请求的文档详情。这就像您进入了一家俱乐部，但某些VIP区域不是普通会员可以进入的。

常见原因分析：

  1. 文档权限设置： 您尝试访问的文档可能被安企CMS后台设置为特定用户组或权限等级才能访问（例如，VIP内容、付费内容、内部资料等）。
  2. 用户组权限不足： 您当前登录的账户所属的用户组（例如普通会员组）没有被授予访问该类型文档或特定文档的权限。
  3. 账户状态异常： 您的账户可能被冻结、降级或者其他原因导致权限受限。
  4. 内容付费： 如果文档是付费内容，您可能需要先完成支付才能查看详情。

解决方法： 解决1002错误需要从权限层面入手：

  • 确认文档权限： 在安企CMS后台管理界面，找到您尝试访问的文档，检查其“阅读等级”、“访问权限”或相关设置，确认该文档是否对所有用户开放，或者仅对特定用户组开放。
  • 核对用户组： 检查您当前登录的用户账户所属的用户组。如果文档详情接口要求更高的权限，您可能需要升级您的用户组（例如从普通会员升级到VIP会员），或者联系网站管理员为您调整用户组权限。安企CMS后台的用户管理模块通常会显示用户所属的用户组及其权限。
  • 联系管理员： 如果上述检查都无法解决问题，或者您不确定具体权限设置，最有效的办法是联系网站管理员。管理员可以查看您的账户权限，并核实文档的访问设置，然后进行必要的调整。
  • 检查支付状态： 如果文档是付费内容，需要通过archiveOrderCheck接口确认是否已支付。

通用排查建议

无论是1001还是1002，当您遇到这些错误时，以下通用排查步骤可能有所帮助：

  • 仔细检查API请求参数： 确保您传入的文档ID或文件名是正确的，并且与实际存在的文档相匹配。错误的ID或文件名可能导致系统无法找到文档，从而间接引发其他错误。
  • 查看完整的API返回信息： 安企CMS在返回错误码时，通常会在msg字段中提供更详细的错误说明，这有助于您更快地定位问题。例如，“未登录”或“权限不足”等提示会直接出现在msg字段中。
  • 检查网络与服务器状态： 确保您的网络连接正常，并且安企CMS服务器正在稳定运行。临时的网络波动或服务器维护也可能导致API请求失败。

通过系统地分析错误码，结合安企CMS提供的文档和后台管理功能，您可以高效地解决这些问题，确保网站内容的顺畅访问。

常见问题 (FAQ)

Q1: 如果文档详情接口没有返回错误码，但data字段为空，那意味着什么？ A1: 这通常意味着API请求本身是成功的，但根据您提供的文档ID或文件名，系统未能找到对应的文档。请检查您传入的文档ID或文件名是否正确，或者该文档是否已被删除、处于非显示状态（status不为1），或者尚未发布。

Q2: 为什么我本地测试时一切正常，部署到服务器后却出现1001/1002错误？ A2: 这种情况很常见。原因可能包括：服务器环境与本地环境的差异导致Token传递失败；跨域配置问题阻止了浏览器发送Token；或者服务器上的内容权限设置比本地更严格。建议检查服务器的Nginx/Apache配置、CORS策略以及安企CMS后台的用户组和文档权限设置。

Q3: 除了手动修改权限，还有没有其他方式来管理用户访问文档的权限？ A3: 有的。安企CMS通常支持用户组管理功能，您可以创建不同的用户组（如普通用户、VIP用户、管理员等），并为每个用户组配置不同的访问权限。然后，在发布或编辑文档时，您可以指定该文档仅对某个或某几个用户组可见，这样就能批量管理文档的访问权限，而无需单独为每个用户设置。此外，一些付费内容模块也可能集成有基于支付状态的权限管理。