You need to enable JavaScript to run this app. 使用Firebase Hosting部署应用(build含index.html)时出现报错
优惠活动
大模型
产品
解决方案
定价
更多

使用Firebase Hosting部署应用(build含index.html)时出现报错

Firebase Hosting 部署异常排查

build目录已存在index.html仍触发部署报错的常见诱因:

  • firebase.json 静态资源路径配置失配:初始化Firebase Hosting阶段默认指向public目录,若未手动修改hosting.public字段为实际打包产物所在的./build路径,CLI会按默认配置路径检索index.html,直接触发文件不存在的报错。
  • 执行部署命令的终端工作目录异常:如果当前终端路径并非项目根目录,即便配置路径完全正确,CLI也无法定位到项目下的build文件夹。可先执行ls命令确认当前路径可直接检索到build文件夹,再运行部署指令。
  • 路径书写存在大小写或层级错误:类Unix环境下文件路径严格区分大小写,比如实际文件夹名为小写build,配置中误写为Build,或是错将路径嵌套为./src/build这类不存在的层级,都会导致CLI无法检索到目标index.html。
  • 本地项目未完成初始化绑定:如果直接复用其他项目的Firebase配置文件,未在当前项目根目录执行firebase init hosting完成项目关联,CLI也会出现路径识别类的异常报错。
  • 目标目录读取权限异常:如果当前运行Firebase CLI的用户没有build目录及内部文件的读取权限,CLI无法正常扫描到index.html,也会触发资源不存在类的报错。可通过chmod命令给build目录添加对应的读取权限后重试。

内容的提问来源于stack exchange,提问作者Agnes Liszka

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.05 17:06:03