本文档列举了在使用火山引擎云解析（DNS）时的排障常见问题。
在云解析 DNS 中添加域名后，域名的 DNS 状态 为 未使用 TrafficRoute 解析。
域名当前的 DNS 服务不是云解析 DNS 提供的，因此云解析 DNS 无法解析该域名。
如果域名是主域名，您需要完成以下步骤在在您的域名注册服务商处添加 DNS 服务器：
在您的域名注册服务商处，将列出的所有 DNS 服务器添加在您域名的 DNS 服务器列表中。
如果域名是子域名，参见 步骤二：在主域名的域名解析服务商处添加 NS 记录。
在云解析 DNS 中添加域名后，域名的 DNS 状态 为 域名待找回。
另一个火山引擎主账号已经添加过该域名，并拥有该域名的解析管理权。
下表描述了在不同场景下推荐的解决方案。
场景 | 推荐的解决方案 | DNS 解析是否会中断 |
|---|---|---|
域名注册在火山引擎，且您的火山引擎主账号在 火山引擎域名服务 拥有该域名的所有权。 | 解决方案一：使用域名注册账号收回解析管理权 | 不会 |
另一个已经添加过该域名，并拥有该域名解析管理权的火山引擎主账号也属于您。 | 解决方案二：转移域名解析管理权 | 不会 |
域名的 DNS 解析服务商不是火山引擎云解析 DNS。 | 解决方案三：添加 TXT 记录收回解析管理权 | 会 |
如果域名注册在火山引擎，且您当前的火山引擎账号在火山引擎域名服务拥有该域名的所有权，您可以使用该账号在不中断 DNS 解析的前提下收回解析管理权。
注意
您可以通过控制台或 OpenAPI 收回解析管理权。
方法一：通过控制台收回解析管理权
方法二：通过 OpenAPI 收回域名解析管理权
在当前火山引擎主账号下调用 CheckRetrieveZone API 收回域名解析管理权。RetrieveType 参数需要被设置为 Domain。
解析管理权收回成功后，您就可以在当前火山引擎主账号下管理该域名的 DNS。
另一个已经添加过该域名，并拥有该域名解析管理权的火山引擎主账号也属于您。您可以登录另一个火山引擎主账号，在不中断 DNS 解析的前提下，把域名解析所有权和所有解析记录转移到当前火山引擎主账号。参见 转移域名解析。
如果域名的 DNS 解析服务商不是火山引擎云解析 DNS，您可以在该域名的解析服务商处添加 TXT 记录为您的火山引擎主账号验证域名所有权。验证成功后，您就可以从另一个火山引擎账号收回解析管理权。
注意
这种方案会造成您的 DNS 解析暂时中断。
首先，您需要从该域名的解析服务商导出您的解析记录。
您可以通过控制台或 OpenAPI 收回解析管理权。
方法一：通过控制台收回解析管理权
参见以下步骤通过控制台收回解析管理权：
如果验证通过，您就可以在当前火山引擎主账号下管理该域名的 DNS。
方法二：通过 OpenAPI 收回域名解析管理权
参见以下步骤通过 OpenAPI 收回域名解析管理权：
RetrieveType 参数需要被设置为 TXT。验证成功后，您就可以从另一个火山引擎账号收回解析管理权。
域名所有权验证完成后，您可以向域名导入解析记录。参见 导入解析记录。
域名的 DNS 状态为“请变更DNS服务器”
云解析 DNS 的服务发生了升级或变更。
该状态可能由以下原因造成：
而且，您的域名不是在 火山引擎域名服务 托管的，或者您的域名是在火山引擎域名服务托管的且开启了 禁止更新锁。
在您的域名注册服务商处，将列出的所有 DNS 服务器添加在您域名的 DNS 服务器列表中。
对于每个导入失败的解析记录，控制台会显示失败原因。您可以根据失败原因参考以下问题排查步骤。
您需要检查完整域名是否满足以下规则：
同时，您还要确保解析记录中的二级域名与解析记录所导入的目标域名相同。例如，解析记录所导入的目标域名为 example.com。同时，您的文件中存在以下记录：
test.sample.com www A default 600 1.1.1.1 是
则控制台会返回“域名不符合规则”错误。
您需要检查是否存在以下问题：
您需要检查是否存在以下问题：
一条解析记录中同时存在完整域名和主机记录。同时，域名的前缀与主机记录不同，则子域名与主机记录冲突。
例如，您的文件中存在以下记录：
test.example.com www A default 600 1.1.1.1 是
那么，完整子域名和主机记录就会发生冲突。
您需要检查解析记录中的 线路 字段使用的线路是否符合您的功能版本。详见 功能版本规格。
您需要检查单条线路（包括 default）对应的记录集中的解析记录数量是否超出了限制。详见 功能版本规格。
您需要检查 TTL 字段的值是否超出了限制。详见 功能版本规格。
您需要检查解析记录中是否存在冲突。详见 避免解析记录冲突或不生效。
您需要检查解析记录的类型是否属于云解析 DNS 支持的类型。参见 解析记录类型。
在云解析 DNS 中，PTR 记录的状态变为 异常。此时，PTR 记录失效。
PTR 记录所对应的火山引擎公网 IP 已到期或被退订。
您需要确保 PTR 记录所对应的公网 IP 处于正常订阅状态。
您添加的解析记录与已有的解析记录冲突。
您需要检查解析记录中是否存在冲突。详见 避免解析记录冲突或不生效。
NS 记录的过期时间一般是 48 小时。您在域名注册服务商处切换权威 DNS 服务器后，新的 NS 记录至少需要 48 小时才能被大部分 Local DNS 服务器缓存。
各运营商 Local DNS 的缓存时间不同。大部分运营商 Local DNS 的缓存时间比较长。因此，运营商 Local DNS 需要较长时间才能更新缓存的 NS 记录。在更新缓存的 NS 记录之前，运营商 Local DNS 会向原域名解析服务商的 DNS 服务器请求解析结果。