Namecheap配置Firebase Hosting后静态内容不显示反显WordPress模板
问题背景
.com域名已转入Namecheap,使用Namecheap BasicDNS作为域名服务器,已按要求添加对应TXT记录、A记录,Firebase控制台显示域名已成功连接Firebase Hosting,但访问域名时未加载托管的Angular静态项目,反而显示未知来源的WordPress模板页面。
相关配置截图:

故障原因
- 存在冲突DNS记录:Namecheap面板中遗留了之前托管WordPress站点时配置的A/AAAA/CNAME记录,或默认生成的泛解析、停放记录优先级高于新添加的Firebase解析记录,请求被转发到原WordPress主机。
- DNS缓存未同步:域名之前的解析记录缓存在本地网络、运营商递归DNS服务器中,TTL过期前新的Firebase解析记录不会生效,请求仍会打到旧的WordPress服务器。
- Firebase解析记录配置不全:Firebase Hosting要求根域必须配置全部指定的A记录,漏配任意一条都可能导致部分地区的请求被路由到错误地址;若www子域记录未正确配置,访问www前缀域名时也会命中旧服务。
- 权威NS记录不匹配:域名转入后若NS记录未完全切换到Namecheap BasicDNS,在Namecheap面板添加的所有解析记录都不会生效,仍使用旧DNS服务商的解析规则。
修复步骤
- 清理冲突解析记录
登录Namecheap DNS管理面板,删除主机记录为@、www、*(泛解析)下所有非Firebase要求的A、AAAA、CNAME、URL跳转记录,注意保留Firebase域名验证用的TXT记录。
按Firebase官方要求补全解析:- 根域(@)添加4条A记录,分别指向:
151.101.1.195151.101.65.195151.101.129.195151.101.193.195 - www子域添加CNAME记录,指向你项目对应的Firebase默认托管域名(格式为
[你的项目ID].web.app)
- 根域(@)添加4条A记录,分别指向:
- 关闭Namecheap无关默认服务
进入域名设置页面,关闭域名停放、默认建站模板、URL转发类功能,避免平台预置规则拦截请求。 - 验证解析生效状态
先清除本地DNS缓存:- Windows系统执行命令:
ipconfig /flushdns - macOS系统执行命令:
sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder
本地执行nslookup 你的域名查看返回IP,若返回IP和上述Firebase提供的IP一致,说明解析已生效;若仍返回旧IP,等待DNS全球同步即可,Namecheap BasicDNS最长同步周期为48小时,多数场景1-2小时即可完成同步。
测试时优先使用无痕模式、或切换手机蜂窝网络访问,排除浏览器缓存、本地网络缓存的影响。
- Windows系统执行命令:
- 校验Firebase侧配置
回到Firebase Hosting自定义域名页面,确认根域、www子域的状态均为已连接,无证书下发失败、记录缺失的提示。若状态异常,可删除现有自定义域名后重新添加,重新完成TXT验证,触发Firebase侧的路由规则刷新和SSL证书签发。 - 校验权威NS记录
执行nslookup -type=NS 你的域名,确认返回的NS服务器全部为Namecheap官方提供的BasicDNS地址,若存在旧服务商的NS地址,在域名管理页将NS记录修改为Namecheap指定的地址即可。
内容的提问来源于stack exchange,提问作者Ramzan
相关产品推荐
相关产品推荐

