Firebase Hosting部署后仅显示欢迎页的问题咨询

1. 如何让网站显示预期的实际页面？ #

• 核对文件位置与Hosting配置
  • 打开项目根目录的firebase.json，查看hosting.public字段（默认值为"public"）——Firebase仅会部署该字段指定目录内的内容。如果你的实际页面存放在其他文件夹（比如dist或build），直接将该字段修改为对应路径即可；若页面已在public目录下，大概率是index.html被默认文件覆盖，把你自己的页面内容替换掉public/index.html即可。
• 本地验证后再部署
  • 先执行firebase serve启动本地模拟器，确认页面能正常显示后，再运行firebase deploy --only hosting重新部署。
• 清除CDN缓存
  • 若部署后仍显示默认页，多数是CDN缓存导致：进入Firebase控制台的Hosting页面，点击“清除缓存”按钮执行清理，或使用浏览器隐私模式访问网站。

2. 为何模拟器环境运行正常，部署后却出问题？ #

• 配置与实际部署目录不匹配
  • firebase init会重置firebase.json中的Hosting配置，默认将部署目录设为public。你之前运行模拟器时，页面可能存放在项目根目录或其他文件夹，模拟器当时使用旧配置或直接读取根目录文件，而部署时严格遵循新配置的public目录，自然部署了默认页。
• 模拟器未加载新配置
  • 执行firebase init后，若未重启模拟器，它会持续使用旧配置读取原页面文件，导致本地显示正常，但部署时采用的是新配置指定的内容。
• 缓存机制存在差异
  • 本地模拟器无CDN缓存，修改文件后立即生效；但部署到线上后，Firebase的CDN会缓存旧页面内容，即便重新部署，缓存未清理的话仍会显示旧的默认页。

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