跳到主要内容

错误码参考文档

文档目的​

本文档用于说明在软件系统访问、调用、部署及分发过程中可能出现的常见错误类型，涵盖前端访问、接口调用、网关策略、CDN 分发与安全控制等环节。 每个错误码均提供错误说明、可能原因、影响范围及处理建议，用于快速定位问题与指导修复。

1001：资源不存在（Resource Not Found）​

错误说明​

请求的资源不存在。用户访问了一个域名或路径，该域名虽然已指向某个服务器或 IP 地址，但实际并未部署对应资源。

可能原因​

  • 域名拼写错误或路径错误
  • DNS 指向正确，但服务器上未部署该资源
  • 服务尚未上线或已被移除
  • 前端路由与后端资源不一致

影响范围​

  • Web 页面无法访问
  • API 请求返回空或错误响应

处理建议​

  • 检查访问的域名与路径是否正确
  • 确认资源是否已正确部署并发布
  • 检查 DNS 配置与服务器资源映射
  • 对外建议返回标准 404 页面或响应

1002：资源被停用或废弃（Resource Disabled or Deprecated）​

错误说明​

请求的资源曾经存在，但当前已被停用、废弃或迁移，且未提供新的访问地址。

可能原因​

  • 服务下线但未设置跳转或说明
  • 资源迁移但未同步更新访问入口
  • 历史接口被废弃但仍被调用

影响范围​

  • 老版本客户端或系统调用失败
  • 第三方集成中断

处理建议​

  • 检查资源是否已迁移或替代
  • 联系系统管理员确认新资源地址
  • 对外接口建议提供明确的废弃说明
  • 内部系统应建立资源生命周期管理机制

1003：资源访问方式不被允许（Method Not Allowed）​

错误说明​

请求使用了资源不支持的访问方式，例如使用 GET 请求访问仅支持 POST 的接口。

可能原因​

  • HTTP 方法使用错误
  • 前端或调用方接口定义不一致
  • 网关或后端接口限制了请求方法

影响范围​

  • 接口调用失败
  • 表单提交或数据操作异常

处理建议​

  • 检查接口文档中定义的请求方法
  • 确认前端或调用方实现是否正确
  • 后端可返回明确的 Method Not Allowed 响应

1004：不允许通过 IP 直接访问（IP Access Not Allowed）​

错误说明​

请求通过服务器或 CDN 的直接 IP 地址访问资源，该访问方式被明确禁止。

可能原因​

  • CDN 仅允许通过绑定域名访问
  • 防止绕过安全策略或证书校验
  • 访问方式不符合部署规范

影响范围​

  • 页面或接口无法加载
  • HTTPS 证书校验失败

处理建议​

  • 使用正式绑定的域名进行访问
  • 确认 CDN、证书与域名配置正确
  • 不建议对外暴露 IP 访问能力

1005：资源重定向异常（Redirection Error）​

错误说明​

请求的资源已被重定向至新的地址，但当前客户端或浏览器未能正确处理该重定向流程。

可能原因​

  • 浏览器或客户端不支持重定向
  • 重定向链路配置错误或循环跳转
  • HTTP/HTTPS 混合跳转问题

影响范围​

  • 页面无法正常加载
  • 请求陷入跳转失败状态

处理建议​

  • 检查重定向规则是否正确
  • 确认跳转协议与目标地址合法
  • 避免多层或循环重定向

1006：资源访问环境不安全（Insecure Access Environment）​

错误说明​

当前访问环境被判定为不安全，不满足资源的安全访问要求。

可能原因​

  • 使用 HTTP 而非 HTTPS 访问
  • 资源要求更高安全级别（如 PQC 纯量子安全隧道）
  • 客户端或设备不支持所需安全协议

影响范围​

  • 访问被拒绝
  • 安全策略触发

处理建议​

  • 使用 HTTPS 或符合要求的安全通道访问
  • 升级客户端或设备安全能力
  • 确认访问环境符合安全策略要求

1007：授权错误（Authorization Required）​

错误说明​

请求的资源为受保护资源，当前请求未提供任何有效的授权或认证信息。

可能原因​

  • 未登录或未获取访问凭证
  • 请求未携带 Authorization 信息
  • 访问了仅限内部或特定角色的资源

影响范围​

  • 用户无法访问受保护内容
  • 接口调用被拒绝

处理建议​

  • 引导用户完成登录或授权流程
  • 检查请求头中是否携带授权信息
  • 明确资源访问权限策略

1008：授权认证失败（Authentication Failed）​

错误说明​

请求携带了认证信息（如 JWT、Token 等），但认证校验失败或信息不合法。

可能原因​

  • Token 过期或被吊销
  • 签名错误或篡改
  • 认证信息格式不正确

影响范围​

  • 已登录用户被强制拒绝访问
  • 自动化接口调用失败

处理建议​

  • 重新进行认证并获取新的凭证
  • 检查 Token 生成与校验逻辑
  • 确认系统时间与签名算法一致

1009：禁止自动化访问（Automated Access Forbidden）​

错误说明​

当前访问行为被判定为自动化访问（如爬虫、机器人或 AI 请求），不符合访问策略。

可能原因​

  • 请求频率异常
  • User-Agent 或行为特征异常
  • 触发反爬虫或风控规则

影响范围​

  • 请求被限制或封禁
  • 自动化任务中断

处理建议​

  • 检查网络环境与访问行为
  • 降低请求频率或使用官方 API
  • 若为合法自动化访问，应申请白名单或授权