近日，不少使用GitHub Pages托管个人网站或项目的开发者发现，在绑定自定义域名时遭遇了“DNS check unsuccessful”的红色警告。这一提示直接导致域名无法生效，网站被迫停留在“xxx.github.io”的默认地址，给用户带来极大不便。GitHub官方技术支持论坛上相关帖子激增，问题集中在“自定义域名DNS验证不通过”这一环节，引发广泛关注。
问题现象：配置完成后仍反复报错
通常，用户希望将购买的域名（如example.com）与GitHub Pages仓库关联，只需在仓库的“Settings”页面下的“Custom domain”栏中输入域名，并按照GitHub官方文档设置DNS记录（如A记录指向GitHub Pages的IP地址，或CNAME指向用户名.github.io）。然而，近期许多用户反映，即便DNS记录已完全按照要求配置并等待数小时，GitHub后台依然显示“DNS check unsuccessful”，自定义域名状态始终为“未验证”。
部分用户表示，同一域名过去曾正常工作，但在近期GitHub更新后突然失效；而另一些新用户则从一开始就无法通过验证。更令人困惑的是，一些用户在第三方DNS检测工具（如whatsmydns.net）中看到全球传播已生效，但GitHub的检测仍然失败，说明问题并非单纯的DNS缓存或传播延迟。
根源分析：多重因素叠加所致
经过多方排查与社区讨论，技术专家初步锁定了几个核心原因：
1. GitHub政策升级：强制要求TXT验证记录
GitHub近期悄然修改了自定义域名的验证策略。过去，仅需设置CNAME或A记录即可完成绑定；而现在，GitHub要求用户在DNS中额外添加一条TXT记录，内容为“github-verification=<验证令牌>”，该令牌可在仓库设置中获取。许多用户忽略了这一步骤，导致验证失败。
2. 根域名（APEX域名）的特殊要求
对于使用根域名（如example.com，而非www.example.com）的用户，GitHub要求必须同时设置A记录指向其IP地址池，并确保没有其他冲突记录。部分用户误将CNAME用于根域名（违反DNS规范），或A记录指向了过时的IP地址（GitHub曾更新过A记录，旧IP已不再使用）。
3. CDN或代理服务干扰
不少用户使用Cloudflare或其他CDN服务来管理DNS。当Cloudflare的代理（橙色云）处于开启状态时，会隐藏真实IP，导致GitHub无法直接解析到正确的服务器。GitHub明确要求自定义域名必须使用“仅DNS”模式（灰色云），否则会触发校验失败。
4. 多级域名或泛域名解析冲突
部分用户设置了泛域名解析（如*.example.com）或存在多个CNAME记录，导致冲突。DNS规范规定，同一节点不能同时存在CNAME和其他记录类型，而GitHub的检测逻辑对此非常敏感。
社区反馈与临时方案
在GitHub Discourse论坛及Twitter上，开发者们纷纷晒出排查日志。用户@dev_ops_2024发帖称：“我花了整整两天重新配置Cloudflare，关闭代理、添加TXT记录、等待48小时，最终才通过检查。” 另一位用户则分享了一个“取巧”方法：先将自定义域名设置为一个无效值并保存，等待几分钟后重新输入正确域名，有时可绕过缓存问题。
GitHub官方工程师也在近期回应称，已注意到相关问题并正在优化验证算法，同时建议用户严格遵循最新的“自定义域名验证指南”。指南强调：必须使用正确的A记录（185.199.108.153等四个IP）、必须为根域名添加TXT验证记录、Cloudflare等CDN必须关闭代理。
专业建议：三步自检
针对当前局面，资深Web开发者李明给出了简明排查步骤：
- 检查记录完整性：使用
dig或nslookup命令确认A记录解析到GitHub的正确IP（共4个，缺一不可），以及TXT记录是否包含正确的令牌。 - 关闭CDN代理：在Cloudflare的DNS设置中，将域名对应的记录改为灰色云（仅DNS）。
- 清除GitHub缓存：在仓库设置中先删除自定义域名，保存后重新添加，并等待最多24小时。
李明还提醒：“不要依赖GitHub的即时校验，有时即使显示失败，实际访问却可能正常。建议同时使用浏览器直接访问域名进行验证。”
结语
GitHub Pages凭借其免费、稳定、支持静态网站等特性，成为开发者展示作品的首选平台。但自定义域名作为“门面”功能，频繁出现的DNS检查失败无疑损害了用户体验。随着GitHub持续更新其安全策略，用户需及时跟进文档变化，避免因配置流程滞后而“卡壳”。对于仍在困扰中的开发者，不妨按照上述步骤逐一排查，并密切关注GitHub官方动态——毕竟，一个可用的自定义域名，不仅是技术实力的象征，更是专业形象的基石。