解决Firebase部署后package.json自定义构建被忽略警告及相关错误

问题详情 #

我用npx create-next-app@latest创建了Next.js项目，配置选了JavaScript、Eslint、Tailwind CSS，没用到src目录、App Router和导入别名；用Figma的Locofy插件生成了自定义布局，本地npm run dev正常，npm run build也能顺利完成。

但在部署到Firebase的流程中遇到了问题：

1. 执行npm install -g firebase-tools时，收到har-validator和uuid的废弃警告，怀疑这是后续问题的诱因，急需这两个包的替代方案。
2. 后续执行firebase experiments:enable webframeworks、firebase init hosting、firebase deploy时，先弹出警告：

WARNING: your package.json contains a custom build that is being ignored. Only the Next.Js default build script (e.g, "next build") is respected. If you have a more advanced custom integration...
然后直接出现模糊错误：Error: an unexpected error has occurred.

已尝试的无效操作 #

• 用管理员权限CMD执行命令
• 关闭本地服务后改用Git Bash操作
• 删除node_modules后重装依赖
• 两次重建项目

解决方案 #

一、har-validator和uuid的替代方案 #

• har-validator：这个包已彻底废弃，官方推荐用@stoplight/spectral（专注API规范校验）或ajv（通用JSON Schema校验库）替代。如果是firebase-tools依赖的该包，无需手动替换，直接升级firebase-tools到最新版本即可，新版本已经更新了依赖：

  npm install -g firebase-tools@latest
  

• uuid：旧版uuid（v3/v4分支）已被标记废弃，推荐使用最新稳定版（v9+），它采用ESM优先的设计，用法更规范。如果是项目直接依赖，执行：

  npm install uuid@latest
  

  若是firebase-tools依赖的，同样升级firebase-tools就能解决。

二、解决Firebase部署的警告和未知错误 #

1. 还原默认build脚本：检查package.json的scripts字段，Locofy插件可能修改了build命令，把它改回Next.js默认的"next build"：

   "scripts": {
     "dev": "next dev",
     "build": "next build",
     "start": "next start",
     "lint": "next lint"
   }
   

2. 重新初始化Firebase配置：删除项目根目录的.firebase文件夹和firebase.json，重新执行firebase init hosting，注意：
   • 确认选择的是目标Firebase项目
   • 输入public目录时直接按回车（启用webframeworks实验后会自动识别Next.js的.next目录）
   • 提示是否覆盖现有文件时选N（除非你确定要重置）
3. 尝试禁用webframeworks实验：如果启用该实验导致兼容性问题，先关闭它：

   firebase experiments:disable webframeworks
   

   然后修改firebase.json为传统Next.js部署配置：

   {
     "hosting": {
       "source": ".",
       "frameworksBackend": {
         "region": "us-central1"
       },
       "ignore": [
         "firebase.json",
         "**/.*",
         "**/node_modules/**"
       ]
     }
   }
   

4. 查看详细错误日志：执行部署时加上--debug参数，获取完整错误信息，方便精准定位问题：

   firebase deploy --debug
   

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