Firebase自定义域名无法访问网站的配置求助

问题概述 #

将React应用部署到Firebase自定义域名后无法访问，更换全新React应用部署仍出现相同错误，但Firebase默认域名（如xxx.web.app）可正常运行，说明问题出在域名配置环节，与应用代码无关。

分步排查与解决 #

1. 确认Firebase控制台域名状态 #

• 登录Firebase控制台，进入目标项目 → Hosting → 自定义域名
• 检查域名状态：必须显示「已激活」，且SSL证书状态为「已颁发」
  • 若显示「待验证」，需完成域名所有权验证（按提示添加TXT/CNAME记录到域名服务商后台）
  • 若SSL证书处于「颁发中」，等待10-30分钟（Firebase自动申请Let's Encrypt证书，存在正常延迟）

2. 核对DNS解析记录 #

登录你的域名服务商后台（如阿里云、GoDaddy），严格按照Firebase控制台给出的要求配置解析：

• 顶级域名（如example.com）：添加A记录，指向Firebase提供的IP地址（以控制台显示的IP列表为准）
• 子域名（如app.example.com）：添加CNAME记录，指向你的Firebase默认域名（如your-project-id.web.app）
• 验证解析生效：在终端执行nslookup 你的自定义域名，确认返回结果与Firebase要求一致

3. 刷新本地DNS缓存 #

本地缓存可能导致解析延迟，执行对应系统命令刷新：

• Windows：ipconfig /flushdns
• macOS：sudo dscacheutil -flushcache
• Linux：sudo systemctl restart nscd（部分发行版适用）

4. 排除浏览器缓存干扰 #

• 清除浏览器缓存（快捷键Ctrl+Shift+Delete），或使用无痕/隐私窗口访问自定义域名
• 暂时关闭VPN、代理工具，避免网络环境影响解析

5. 验证Firebase配置文件 #

确认项目根目录的firebase.json配置正确，React应用需指向build目录，同时配置路由重写：

{
  "hosting": {
    "public": "build",
    "ignore": [
      "firebase.json",
      "**/.*",
      "**/node_modules/**"
    ],
    "rewrites": [
      {
        "source": "**",
        "destination": "/index.html"
      }
    ]
  }
}

6. 重新部署并强制刷新CDN缓存 #

执行以下命令重新部署应用，确保资源同步：

npm run build
firebase deploy --only hosting

部署完成后，在Firebase控制台Hosting页面点击「刷新缓存」按钮，强制CDN更新内容

内容的提问来源于stack exchange，提问作者Tapesh Patel