GitHub Pages自定义域名解析失败,DNS正常已生效,求排查方向
检查组织仓库的GitHub Pages部署状态
进入组织仓库的「Settings」→「Pages」页面,确认部署分支和目录设置正确,且存在最近成功部署的记录。即便DNS配置无误,若部署失败或未触发部署,站点也无法正常解析。验证CNAME记录的精确性
手动核对CNAME记录:主机名是否为你设定的域名(如autovisita.es或对应www子域名),目标值是否严格为<组织名>.github.io,注意确保目标值全为小写(GitHub Pages域名不区分大小写,但避免格式错误更稳妥)。清理本地DNS缓存
全网DNS生效不代表本地设备缓存已更新,可执行以下命令清理缓存:- Windows:
ipconfig /flushdns - macOS/Linux:
sudo dscacheutil -flushcache或sudo systemd-resolve --flush-caches
之后用nslookup autovisita.es或dig autovisita.es命令,确认本地解析的IP是否匹配GitHub Pages官方IP段。
- Windows:
检查组织的GitHub Pages权限与安全设置
确认组织账号是否开启「Pages settings」中的「Enforce HTTPS」选项但证书未生效——强制HTTPS但证书未颁发可能导致解析异常。同时排查组织是否有仓库访问的额外限制(如IP白名单等)。确认域名状态正常
在域名注册商后台查看域名是否过期、被锁定,或存在DNSSEC验证异常(如「clientHold」等标记),这些状态问题会直接影响域名解析。更换网络环境测试
尝试用手机流量、其他Wi-Fi网络访问,排除本地运营商DNS劫持或缓存未同步的问题,部分地区运营商的DNS更新速度可能慢于全网检测工具。核对仓库内的CNAME文件
若组织仓库中手动添加了CNAME文件,确认文件内容与DNS配置的域名完全一致,无多余空格或换行。根域名配置对应文件内容为autovisita.es,www子域名则对应www.autovisita.es。
内容的提问来源于stack exchange,提问作者dontic

