无法部署Firebase Functions：数据校验错误

架构老林

2026-7-15

Firebase Functions部署报错：Invalid response body (incorrect data check) 解决方法

确认Artifact Registry API已启用
登录Google Cloud控制台，找到你的项目my-project，搜索「Artifact Registry API」，检查它的状态是否为已启用。如果未启用，手动开启后重新尝试部署。
排查网络环境干扰
这个错误大概率是网络请求过程中数据校验失败导致的，比如代理、VPN或者本地防火墙拦截了请求。可以试试关闭VPN、切换到手机热点这类稳定网络，或者检查防火墙规则是否允许访问serviceusage.googleapis.com和artifactregistry.googleapis.com。
重新认证Firebase CLI
执行以下命令重置CLI的身份凭证：
```
firebase logout
firebase login
```
完成重新登录后再部署Functions。
检查Node.js版本是否兼容
用node -v查看本地Node.js版本，Firebase Functions对版本有要求（推荐用18.x或20.x这类LTS版本），如果版本不符，切换到对应版本后再试。
重置本地依赖
进入Functions目录，执行以下命令清理并重新安装依赖：
```
rm -rf node_modules package-lock.json
npm install
```
依赖重装完成后再尝试部署。