使用Firebase部署Next.js项目时遇path参数类型错误求助

问题描述 #

我尝试将Next.js项目部署到Firebase托管，启用Next.js优化后遇到部署错误，命令行输出如下：

=== Deploying to 'web1'...

i  deploying functions, database, storage, hosting
i  functions: preparing codebase firebase-frameworks-web1-142ec for deployment
i  functions: ensuring required API cloudfunctions.googleapis.com is enabled...
i  functions: ensuring required API cloudbuild.googleapis.com is enabled...
i  artifactregistry: ensuring required API artifactregistry.googleapis.com is enabled...
✔  artifactregistry: required API artifactregistry.googleapis.com is enabled
✔  functions: required API cloudbuild.googleapis.com is enabled
✔  functions: required API cloudfunctions.googleapis.com is enabled
i  functions: Loaded environment variables from .env.
i  functions: preparing .firebase/web1-142ec/functions directory for uploading...
i  functions: packaged /blog/.firebase/web1-142ec/functions (70.68 MB) for uploading
i  functions: ensuring required API run.googleapis.com is enabled...
i  functions: ensuring required API eventarc.googleapis.com is enabled...
i  functions: ensuring required API pubsub.googleapis.com is enabled...
i  functions: ensuring required API storage.googleapis.com is enabled...
✔  functions: required API eventarc.googleapis.com is enabled
✔  functions: required API run.googleapis.com is enabled
✔  functions: required API storage.googleapis.com is enabled
✔  functions: required API pubsub.googleapis.com is enabled
i  functions: generating the service identity for pubsub.googleapis.com...
i  functions: generating the service identity for eventarc.googleapis.com...

Error: An unexpected error has occurred.

日志文件中的错误详情：

[debug] [2023-05-12T13:26:53.454Z] TypeError [ERR_INVALID_ARG_TYPE]: 
    The "path" argument must be of type string. Received undefined
    at new NodeError (node:internal/errors:399:5)
    at validateString (node:internal/validators:163:11)
    at Object.join (node:path:1172:7)
    at Config.path (/lib/node_modules/firebase-tools/lib/config.js:123:45)
    at RulesDeploy.addFile (/lib/node_modules/firebase-tools/lib/rulesDeploy.js:37:46)
    at default_1 (/lib/node_modules/firebase-tools/lib/deploy/storage/prepare.js:39:25)
    at process.processTicksAndRejections (node:internal/process/task_queues:95:5)
    at async chain (/lib/node_modules/firebase-tools/lib/deploy/index.js:38:9)
    at async deploy (/lib/node_modules/firebase-tools/lib/deploy/index.js:95:5)
[error] Error: An unexpected error has occurred.

问题根源 #

从日志堆栈可以看出，错误发生在Storage规则部署环节：Firebase CLI尝试加载Storage规则文件时，传入的路径参数为undefined，说明要么firebase.json里配置的规则路径无效，要么对应文件不存在。

具体解决步骤 #

1. 检查并修正firebase.json的Storage配置 #

打开项目根目录的firebase.json：

• 如果存在storage字段，确认rules对应的文件路径是否正确（比如是否为"rules": "storage.rules"），且该文件确实在项目根目录。
• 若不需要自定义Storage访问规则，直接删除整个storage配置块，避免CLI尝试加载不存在的规则文件。

2. 只部署需要的模块 #

如果项目不需要部署Database、Storage等模块，直接指定部署Hosting和Functions，跳过不必要的流程：

firebase deploy --only hosting,functions

3. 清理Firebase CLI缓存 #

缓存异常也可能导致这类问题，清理后再重试：

firebase clear
firebase deploy

4. 降级Firebase CLI版本（可选） #

若为新版本CLI的兼容性bug，尝试降级到稳定版本（如11.25.0）：

npm install -g firebase-tools@11.25.0

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