返回码与排查

返回码说明请求在哪一步失败。排查时先看返回码,再看标识、目标地址、校验状态和记录编号。把返回码与业务处理对应起来,可以避免把不存在、无权限和校验失败混为一类问题。记录编号是把返回码与一次具体请求对应起来的依据。

返回码的作用

一次解析经过提交标识、状态校验、记录查询、返回结果四步。返回码对应失败发生的环节,帮助调用方决定是修正请求、补充权限,还是暂停使用结果。

返回码用于区分不存在、无权限和校验失败。三类问题的处理方式不同,混在一起会导致无效重试,甚至把不可信结果带入业务。

DNS 返回码

DNS 返回码描述解析服务器对查询的处理结果。先确认查询是否完成,再判断名称、区域和服务器责任范围。

返回码含义处理动作
NOERROR查询完成检查答案是否符合预期
FORMERR请求格式错误核对标识和记录类型
SERVFAIL解析服务器处理失败稍后重试,检查解析服务器状态
NXDOMAIN名称不存在核对标识是否完整、是否已注销
REFUSED服务器拒绝查询检查来源地址和访问策略
NOTAUTH服务器不负责该区域使用正确的解析服务器
NOTZONE名称不在指定区域核对区域和标识

平台错误类型

平台错误类型更贴近登记和授权状态,用于补充 DNS 返回码无法说明的问题。标识已停用与已注销不同:停用期间记录仍保留,注销后不再返回目标地址。处理时不要用同一套重试策略。

  • 标识格式错误:标识包含非法字符或段数不完整。
  • 标识不存在:登记记录中没有该标识。
  • 标识已停用:标识暂停解析,记录仍保留。
  • 标识已注销:标识退出服务,不再返回目标地址。
  • 校验失败:记录签名或版本校验未通过。
  • 无权限:调用方不在授权范围内。

排查顺序

排查从返回码开始,再沿标识、记录、权限和记录编号逐项确认。一次只改一个变量,才能判断变化来自哪一步。

排查时保留完整返回码与请求参数,按提交、校验、查询、返回的顺序逐段核对。确认某一环节的原因后只修改该环节的输入,避免同时调整标识、地址和凭据导致原因无法区分。

  1. 核对返回码和错误类型。
  2. 核对标识是否完整、大小写是否正确。
  3. 核对目标地址、记录版本和校验状态。
  4. 核对调用方凭据和授权范围。
  5. 使用记录编号查询本次解析记录。

处理原则

标识不存在或已注销时停止请求;校验失败时暂停使用结果;无权限时检查授权范围,不通过重复请求绕过限制。NOERROR 只说明查询完成,不代表答案符合业务预期,仍需核对目标地址和记录版本。

同一返回码在不同环节出现时,以请求参数和记录编号区分,不凭经验归类。

返回 NXDOMAIN 是否等于标识注销?
不等于。名称不存在可能来自标识不完整、拼写错误,也可能来自注销。先核对标识,再查登记状态。
校验失败能否先使用结果再排查?
不能。校验失败说明签名或版本未通过,结果不应进入业务,应暂停使用并联系登记节点。
无权限时重复请求会恢复吗?
不会。检查凭据有效期和授权范围,按接入流程调整授权,不要用重复请求试探限制。

需要协助排查

提供标识、记录编号、时间和完整返回码,便于定位具体请求。

联系接入