You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Firebase Serve/Deploy无法加载Vue项目新版本,现显示默认欢迎页

解决Firebase Hosting显示默认页面而非Vue项目的问题

具体排查与修复步骤

  • 核对firebase.json配置
    打开项目根目录的firebase.json,确认hosting下的public字段值为"dist",同时检查重写规则是否正确配置(Vue单页应用需要重写所有路由到index.html)。标准配置示例:
    {
      "hosting": {
        "public": "dist",
        "ignore": [
          "firebase.json",
          "**/.*",
          "**/node_modules/**"
        ],
        "rewrites": [
          {
            "source": "**",
            "destination": "/index.html"
          }
        ]
      }
    }
    
  • 验证dist文件夹有效性
    执行npm run build后,打开dist文件夹,确认存在index.html以及js、css等静态资源。打开index.html检查资源引用路径,确保是相对路径或正确的根路径,避免因资源404导致Firebase回退到默认页面。
  • 清除Firebase本地缓存
    执行命令firebase serve --clear,强制清空本地缓存后再启动服务,排除旧缓存内容的干扰。
  • 检查Firebase控制台部署记录
    登录Firebase控制台进入Hosting页面,查看部署历史,确认最近一次部署是否成功上传了dist内的所有文件。若之前部署有误,可选择回滚到正常版本。
  • 确认Vue项目的vue.config.js配置
    若项目根目录存在vue.config.js,检查publicPath设置:部署到根域名时设为"/"或留空,部署到子路径则对应设置子路径,避免资源加载路径错误。示例:
    module.exports = {
      publicPath: '/'
    }
    
  • 检查文件权限
    确保dist文件夹及其内部文件的读取权限正常,无访问限制,避免Firebase无法读取项目文件。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.07.26 21:44:56