Firebase部署React应用默认域名未自动加载index.html问题排查

根本原因 #

该异常是自定义域名与Firebase默认域名的Hosting规则生效范围不匹配导致的，核心触发逻辑如下：

• 你绑定的app.web自定义域名虽然已完成DNS解析，能让Firebase边缘节点定位到当前项目的静态文件（因此手动添加/index.html时可正常访问），但存在以下几种配置问题中的一种或多种：
  1. 域名未在Firebase项目中完成完全关联验证；若项目启用了多站点功能，该域名可能被错误绑定到了其他空的Hosting站点，导致根路径/请求无法触发Firebase内置的「自动映射根路径到index.html」逻辑，也未应用你配置的rewrites规则，直接返回默认的Site Not Found页面。
  2. 该域名此前曾绑定到已下线的旧项目，Firebase CDN节点残留了旧项目针对该域名根路径的404缓存，只有明确请求/index.html这类静态文件时才会回源获取新项目的内容。
• 你当前的rewrites规则写法存在小概率的根路径漏匹配问题：缺少前导斜杠的**在部分Firebase Hosting边缘节点的匹配逻辑中，不会覆盖空路径（即根路径/），进一步放大了异常。
• Firebase默认分配的firebase.com域名是项目创建时自动绑定的原生域名，所有Hosting规则（包括内置静态索引、自定义rewrites）都会正常生效，因此无异常。

可行修复方案 #

• 核对Firebase Console中Hosting模块的域名列表，确认app.web域名处于「已连接」状态：如果存在验证未完成、待生效的提示，按要求补充对应的DNS TXT/CNAME记录，等待关联状态更新为正常后再测试。
• 若项目启用了多站点功能，确认自定义域名绑定的是当前执行部署的站点，而非其他空站点。
• 确认域名关联正常的情况下，在Hosting的缓存设置中触发全量缓存清除，等待1-2小时让CDN节点的旧404缓存失效。
• 修正firebase.json中的rewrites规则，确保路径匹配覆盖根路径：将source字段调整为带前导斜杠的"/**"，避免漏匹配根路径请求，修改后的完整配置如下：

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

• 执行firebase deploy --only hosting重新部署配置，部署完成后10分钟即可测试自定义域名的根路径访问。

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