返回码的作用
一次解析经过提交标识、状态校验、记录查询、返回结果四步。返回码对应失败发生的环节,帮助调用方决定是修正请求、补充权限,还是暂停使用结果。
返回码用于区分不存在、无权限和校验失败。三类问题的处理方式不同,混在一起会导致无效重试,甚至把不可信结果带入业务。
DNS 返回码
DNS 返回码描述解析服务器对查询的处理结果。先确认查询是否完成,再判断名称、区域和服务器责任范围。
| 返回码 | 含义 | 处理动作 |
|---|---|---|
| NOERROR | 查询完成 | 检查答案是否符合预期 |
| FORMERR | 请求格式错误 | 核对标识和记录类型 |
| SERVFAIL | 解析服务器处理失败 | 稍后重试,检查解析服务器状态 |
| NXDOMAIN | 名称不存在 | 核对标识是否完整、是否已注销 |
| REFUSED | 服务器拒绝查询 | 检查来源地址和访问策略 |
| NOTAUTH | 服务器不负责该区域 | 使用正确的解析服务器 |
| NOTZONE | 名称不在指定区域 | 核对区域和标识 |
平台错误类型
平台错误类型更贴近登记和授权状态,用于补充 DNS 返回码无法说明的问题。标识已停用与已注销不同:停用期间记录仍保留,注销后不再返回目标地址。处理时不要用同一套重试策略。
- 标识格式错误:标识包含非法字符或段数不完整。
- 标识不存在:登记记录中没有该标识。
- 标识已停用:标识暂停解析,记录仍保留。
- 标识已注销:标识退出服务,不再返回目标地址。
- 校验失败:记录签名或版本校验未通过。
- 无权限:调用方不在授权范围内。
排查顺序
排查从返回码开始,再沿标识、记录、权限和记录编号逐项确认。一次只改一个变量,才能判断变化来自哪一步。
排查时保留完整返回码与请求参数,按提交、校验、查询、返回的顺序逐段核对。确认某一环节的原因后只修改该环节的输入,避免同时调整标识、地址和凭据导致原因无法区分。
- 核对返回码和错误类型。
- 核对标识是否完整、大小写是否正确。
- 核对目标地址、记录版本和校验状态。
- 核对调用方凭据和授权范围。
- 使用记录编号查询本次解析记录。
处理原则
标识不存在或已注销时停止请求;校验失败时暂停使用结果;无权限时检查授权范围,不通过重复请求绕过限制。NOERROR 只说明查询完成,不代表答案符合业务预期,仍需核对目标地址和记录版本。
同一返回码在不同环节出现时,以请求参数和记录编号区分,不凭经验归类。
- 返回 NXDOMAIN 是否等于标识注销?
- 不等于。名称不存在可能来自标识不完整、拼写错误,也可能来自注销。先核对标识,再查登记状态。
- 校验失败能否先使用结果再排查?
- 不能。校验失败说明签名或版本未通过,结果不应进入业务,应暂停使用并联系登记节点。
- 无权限时重复请求会恢复吗?
- 不会。检查凭据有效期和授权范围,按接入流程调整授权,不要用重复请求试探限制。