Firebase App Hosting配置自定义域名:CNAME验证失败排查求助
Firebase验证Squarespace自定义域名CNAME记录失败的调试思路
核实CNAME记录配置准确性
确认Squarespace DNS设置中的CNAME记录完全匹配Firebase控制台给出的要求:- 主机名(如
www或自定义子域名)与Firebase指定的一致,不要多填或漏填字符 - 目标值完全复制Firebase提供的内容,注意末尾的点号是否需要保留(部分DNS服务商自动补全,部分需手动添加)
- 确保记录类型是CNAME,而非A/AAAA等其他类型
- 主机名(如
手动查询DNS记录生效状态
使用命令行工具直接查询DNS解析结果,绕过本地缓存:- 执行
dig @8.8.8.8 [你的子域名] CNAME(如dig @8.8.8.8 www.example.com CNAME),查看返回的目标值是否与Firebase要求一致 - 或用
nslookup -type=CNAME [你的子域名] 8.8.8.8,如果返回结果不符,说明Squarespace的DNS记录未同步或配置错误
- 执行
排查DNS记录冲突
- 检查Squarespace DNS列表中,是否存在同一主机名的其他CNAME/A记录,旧记录会导致解析冲突,需删除多余记录
- 确认域名的DNS服务器已切换为Squarespace提供的服务器(第三方域名需手动修改,Squarespace注册域名默认已配置),否则在Squarespace添加的记录不会生效
检查Firebase端配置
- 刷新Firebase控制台的域名管理页面,尝试点击「重新验证」按钮(若有),触发重新检测
- 确认该域名未绑定到其他Firebase项目,一个域名仅能关联一个项目,需先解绑旧项目再重新绑定
排查特殊服务干扰
- 若域名使用了Cloudflare等CDN服务,暂时关闭代理模式(橙色云朵图标),避免CDN缓存或改写DNS记录影响验证,通过后再重新开启
- 若配置了DNSSEC,可暂时关闭该功能,部分场景下DNSSEC会导致解析异常,验证完成后再恢复配置
内容的提问来源于stack exchange,提问作者Gaurang
相关产品推荐
相关产品推荐

