Firebase自定义域名无需指定/index.html访问主页的配置及Chrome浏览器异常排查

作为Firebase新手遇到这种情况很正常，我帮你拆解成两个部分来解决：先搞定域名默认指向主页的配置，再排查Chrome登录状态下的异常。

一、配置Firebase Hosting让域名自动指向index.html #

Firebase Hosting默认应该会把根路径指向index.html，但可能你的配置没到位，按下面步骤检查调整：

1. 修改firebase.json的Hosting配置
   打开项目根目录的firebase.json，确保Hosting部分包含以下关键配置：

   {
     "hosting": {
       "public": "public", // 确认你的静态文件目录，index.html要放在这里
       "ignore": [
         "firebase.json",
         "**/.*",
         "**/node_modules/**"
       ],
       "rewrites": [
         {
           "source": "**",
           "destination": "/index.html"
         }
       ],
       "cleanUrls": true, // 自动映射无后缀路径到对应HTML文件
       "trailingSlash": false // 避免URL自动添加斜杠，保持路径整洁
     }
   }
   

   • rewrites规则会把所有请求转发到index.html，不管是根路径还是子路径，适合静态主页或单页应用场景；
   • cleanUrls开启后，访问你的域名会自动匹配到你的域名/index.html。

2. 重新部署Hosting配置
   在终端运行命令更新线上配置：

   firebase deploy --only hosting
   

   部署完成后，先在无痕模式测试，确认根路径能正常跳转至主页。

二、排查Chrome登录状态下的异常问题 #

因为无痕和移动端访问正常，说明问题大概率出在Chrome的缓存、扩展或用户专属配置上，按以下步骤排查：

• 强制清除该域名的缓存和Cookie
  Chrome登录状态下会保存用户专属的缓存数据，你可以：

  1. 打开Chrome设置 → 隐私和安全 → 清除浏览数据；
  2. 勾选「缓存的图片和文件」「Cookie及其他网站数据」，时间范围选「所有时间」；
  3. 点击「清除数据」，之后重启Chrome再测试访问。

• 硬刷新页面
  有时候缓存没清干净，按Ctrl+Shift+R（Windows）或Cmd+Shift+R（Mac）强制刷新，跳过本地缓存加载最新资源。

• 禁用所有Chrome扩展
  部分扩展（比如广告拦截器、代理工具、脚本注入类插件）可能会干扰域名的重定向逻辑。打开Chrome的扩展管理页面，暂时禁用所有扩展，再测试访问，如果恢复正常，再逐个排查是哪个扩展导致的问题。

• 检查站点权限设置
  访问你的域名，点击地址栏的锁图标 → 站点设置，看看是否有异常的权限配置，比如是否阻止了重定向、或者限制了资源加载，把相关选项恢复默认即可。

• 配置缓存头避免旧规则残留
  如果之前的Hosting配置有缓存index.html的规则，可能导致浏览器一直加载旧配置。可以在firebase.json的Hosting里添加缓存头配置：

  "headers": [
    {
      "source": "**/*.html",
      "headers": [
        {
          "key": "Cache-Control",
          "value": "no-cache, no-store, must-revalidate"
        }
      ]
    }
  ]
  

  重新部署后，浏览器就不会缓存HTML文件，确保加载最新的重定向规则。

按照上面的步骤操作，应该就能解决你的问题了。

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