Firebase Functions部署报错：缺失配置JSON文件的解决方案

云上老周

2026-8-1

Firebase Functions部署缺失服务账号JSON文件问题解决

场景：离开Firebase约2年后修复Functions，更新依赖后执行部署命令firebase deploy --only functions:mpiEnrollment，报错提示找不到../config/pukinn2-1b14e9a65ea1.json，config目录存在但无该文件。
排查结论：实际是缺失serviceAccount.json文件，此前误以为仅需firebaseConfig即可，实际Functions后台操作需要该服务账号文件。
解决步骤：
1. 在Firebase控制台进入「应用设置」-「服务账号」标签页，下载对应的serviceAccount.json文件
2. 将文件放入指定的config目录
3. 升级项目中所有过时的依赖包
4. 重新执行部署命令即可成功

serviceAccount.json模板

{
    "type": "service_account",
    "project_id": "yourProjectName",
    "private_key_id": "...a89fds980asddfs890dsa...",
    "private_key": "-----BEGIN PRIVATE KEY-----\n...ahjk8123hdjak91hjkdsa...\n-----END PRIVATE KEY-----\n",
    "client_email": "firebase-adminsdk-0000f@yourProject.iam.gserviceaccount.com",
    "client_id": "...1234567...",
    "auth_uri": "https://accounts.google.com/o/oauth2/auth",
    "token_uri": "https://oauth2.googleapis.com/token",
    "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
    "client_x509_cert_url": "https://www.googleapis.com/robot/v1/metadata/000/firebase-adminsdk-0000%40yourproject.iam.gserviceaccount.com"
}