TXT记录验证不通过怎么办?
简答:TXT记录验证不通过,先不要反复点击验证。先用 nslookup -q=NS 查出当前权威DNS,再用 nslookup -q=TXT 或 dig 查询完整验证主机名;如果权威DNS没有目标值,优先检查主机记录和记录值,如果公网能查到完整目标值但平台仍失败,再按平台要求等待后重试。
定义:TXT记录验证,是验证平台查询指定主机名下的TXT记录,并将返回值与平台给出的验证字符串进行匹配。
先做这一步:确认权威DNS和验证记录是否真的可见
控制台显示“已保存”,不等于公网DNS已经查询到记录。先确认域名当前由哪组权威DNS服务器管理,再到对应的DNS服务商添加或修改TXT记录。华为云手动DNS验证说明也要求先确认实际域名托管平台,再检查主机记录、记录类型和记录值。
- Windows CMD:打开“开始”菜单,搜索“命令提示符”并打开;普通查询不需要管理员权限。执行:
nslookup -q=NS example.com。把example.com换成你的根域名,记录返回的NS服务器名称。 - macOS或Linux终端:打开“终端”,执行:
dig NS example.com +short。如果系统没有dig,可先使用:nslookup -q=NS example.com。 - 直接查询权威服务器:把上一步得到的某个NS名称替换到命令末尾。例如:
nslookup -q=TXT _acme-challenge.example.com ns1.example-dns.com,或在macOS/Linux执行:dig @ns1.example-dns.com TXT _acme-challenge.example.com +short。
如果直接问权威DNS时没有目标TXT值,问题通常仍在记录填写、DNS托管平台或NS切换,而不是本地缓存。若权威DNS已有目标值,但普通查询仍没有,说明递归DNS或缓存尚未更新。
| 查询结果 | 通常说明 | 下一步 |
|---|---|---|
| NXDOMAIN | 查询的主机名不存在,常见于主机名写错、验证前缀漏写或域名后缀重复 | 重新核对完整验证主机名,并确认记录加在当前权威DNS平台 |
| 名称存在但没有TXT字段 | 主机名存在,但没有发布TXT记录,或查询的记录类型不对 | 检查记录类型是否为TXT,以及是否把记录加到了根域名或错误子域名 |
| 只返回旧值 | 修改尚未传播,或查询仍经过旧的递归缓存 | 对比权威DNS与公共查询结果,按TTL和平台说明等待 |
| 返回目标值 | 公网已能看到验证字符串 | 核对大小写、空格和引号后,按平台要求等待并重试一次 |
想进一步理解记录类型、TTL和查询返回值,可继续查看DNS查询结果怎么看。
第二步:逐项核对主机记录、TXT值和记录冲突
TXT验证失败最常见的不是“DNS完全不可用”,而是验证平台要求的主机名或字符串没有被完整发布。阿里云帮助中心说明,TXT可用于域名归属验证和证书验证,并提醒关注记录类型、主机记录、记录值及记录冲突等问题;请以实际DNS服务商的字段规则为准。
| 核对项 | 怎么检查 | 容易出现的错误 |
|---|---|---|
| 记录类型 | 必须选择TXT,不要误选A、CNAME或MX | 把“验证方式”为DNS误解成需要添加CNAME,或复制了错误记录类型 |
| 主机记录 | 根域名有的服务商填@或留空;子域名应填前缀;完整主机名如_acme-challenge.example.com要按平台规则填写 | 重复填写域名后缀,或漏掉_acme-challenge、_dnsauth等验证前缀 |
| 记录值 | 从验证平台复制完整字符串,再检查首尾空格、换行、大小写和隐藏字符 | 只复制了部分值,粘贴时带入换行,或手动改动了等号后的内容 |
| 引号 | 按DNS服务商输入框规则填写,不要自行额外添加成对引号 | 有的平台界面会自动显示引号,用户再次输入后导致值被重复包装 |
| 同名记录 | 检查同一主机名是否已有CNAME或旧验证记录 | 同名CNAME通常不能与TXT并存;若平台要求使用CNAME验证,应按平台给出的目标名称查询,而不是继续查TXT |
同一主机名下存在多条TXT并不一定错误,例如验证值可能与SPF同时存在。关键是查询结果中是否包含平台要求的完整目标值,不要因为看到其他TXT就删除业务记录。
如果你使用的是阿里云、腾讯云DNSPod或华为云,控制台字段名称可能不同;主机记录是填@、留空还是填前缀,必须以该平台当前页面提示为准,不要套用其他服务商的填写方式。
第三步:用递归DNS对比结果,区分缓存、NS切换和记录未发布
Windows CMD:在命令提示符中执行默认查询:nslookup -q=TXT _acme-challenge.example.com。再指定Google公共DNS查询:nslookup -q=TXT _acme-challenge.example.com 8.8.8.8。Google Workspace官方文档给出了Windows、Mac和Linux使用nslookup查询TXT的方式,也说明可以在命令后指定8.8.8.8进行对照查询,返回多个TXT值时应逐条检查是否含有目标字符串。
macOS/Linux终端:执行:dig TXT _acme-challenge.example.com +short;再执行:dig @8.8.8.8 TXT _acme-challenge.example.com +short。输出中的每一行通常代表一个TXT字符串,带引号不代表引号一定属于实际记录值,判断时应以平台要求的完整内容为准。
可以把结果按下面方式判断:
- 默认DNS和
8.8.8.8都查不到,但权威DNS也查不到:记录没有发布到当前权威DNS,先回到DNS控制台检查。 - 权威DNS能查到,默认DNS查不到:更像是缓存、TTL或NS切换尚未完成,先等待,不要连续重复验证。
- 不同递归DNS返回不同值:可能存在传播差异,或域名近期更换过权威DNS;继续以权威DNS返回值和验证平台要求为基准。
- 所有查询都能看到目标值,但平台仍失败:检查是否查错了验证主机名、平台是否要求完整值匹配、是否存在旧验证任务或短时间重复触发限制。
不同平台给出的等待时间并不完全相同。Google Workspace文档写明DNS变更最长可能需要72小时,取决于TTL;腾讯云SSL证书故障处理文档写明其场景下解析全球生效时间为0至48小时,并提示频繁点击验证可能触发等待5分钟的限制。这里的时间是平台文档中的场景说明,不是所有域名都固定需要等待同样时长。
如需单独判断修改后的等待时间,可参考DNS修改后多久生效,不要只根据某一次本地查询下结论。
第四步:按结果修正后再验证,仍失败时准备完整证据
- 记录值错误:重新复制验证平台给出的完整字符串,保存后再次查询,不要只看控制台的保存提示。
- 主机名错误:把验证平台显示的完整名称与命令中的查询名称逐字符对照,重点检查前缀、下划线和域名后缀。
- 当前DNS平台错误:重新查询NS记录,确认修改记录的平台确实负责当前域名;如果刚更换过NS,应同时记录旧NS和新NS的查询结果。
- 同名CNAME冲突:不要直接删除正在使用的业务记录。先确认验证平台是否支持改用CNAME,或联系DNS服务商确认安全调整方式。
- 已经查询到目标值:按照验证平台要求等待后再操作。腾讯云文档提示,短时间多次点击状态检查可能触发限频;因此应避免连续重复提交。
如果等待后仍失败,整理以下信息再联系验证平台或DNS服务商:验证域名、完整主机记录、记录类型、记录值是否已脱敏、权威NS查询结果、默认DNS查询结果、指定DNS查询结果、失败提示原文以及最近一次修改时间。这样比只提供“验证失败”更容易定位。
如果问题同时影响企业业务系统的域名解析,可继续参考跨境办公DNS异常排查,按解析、连接和线路分层判断。
常见问题
TXT记录已经在控制台保存,为什么验证平台还是查不到?
控制台保存只说明配置提交成功,不代表当前权威DNS已经发布该记录。先用 nslookup -q=NS 查出权威DNS,再直接向权威服务器查询TXT;如果权威服务器没有目标值,优先检查修改平台、主机记录和记录值。
根域名的TXT记录主机记录应该填@、留空还是完整域名?
不同DNS服务商的字段规则可能不同。根域名有的平台使用@,有的平台要求留空;验证子域名时通常填写平台给出的前缀。不要把完整域名重复粘贴到会自动补后缀的主机记录字段中,应以当前控制台说明为准。
查询结果里有多条TXT记录,需要删除其他记录吗?
不一定。SPF、域名验证和其他业务可以共存于同一主机名下。先确认返回结果中是否包含验证平台要求的完整目标值,除非明确确认旧记录无用,否则不要删除正在使用的TXT记录。
TXT值已经能查到,但平台仍提示验证失败怎么办?
核对查询的是否为完整验证主机名,记录值是否完全匹配,是否存在同名CNAME、旧验证任务或重复提交限制。确认无误后按平台要求等待,再重试一次;仍失败时提交查询结果和失败提示。
TXT记录验证一般要等多久?
没有统一固定时间。Google Workspace文档说明DNS变更最长可能需要72小时,腾讯云SSL证书文档在其场景中写明解析全球生效时间为0至48小时;实际还会受到TTL、NS切换和平台审核流程影响。