Strapi添加谷歌云存储上传插件启动时报JSON输入意外结束错误
报错原因
该报错是GCS_SERVICE_ACCOUNT环境变量的JSON字符串格式存在问题,Strapi读取时无法完成JSON解析,Windows环境下通常由环境变量转义错误、JSON内容截断导致。
解决方案
步骤1:校验原始服务账号JSON合法性
打开你从谷歌云平台下载的服务账号JSON文件,复制全部内容到代码编辑器中,确认JSON格式完整,没有缺失括号、引号,不存在末尾多余逗号等语法错误。
步骤2:正确配置环境变量
根据你的配置场景选择对应处理方式:
- 若使用项目根目录
.env文件配置:将完整JSON字符串用单引号直接包裹即可,示例如下:
GCS_SERVICE_ACCOUNT='{"type":"service_account","project_id":"你的项目ID","private_key_id":"你的私钥ID","private_key":"-----BEGIN PRIVATE KEY-----\n你的私钥内容\n-----END PRIVATE KEY-----\n","client_email":"你的服务账号邮箱","client_id":"你的客户端ID","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":"你的证书地址"}'
注意不要修改JSON内的\n转义换行符,不要将其替换为真实换行或者空格。
- 若使用Windows系统环境变量配置:需要将JSON内所有双引号前添加反斜杠转义,不需要外层单引号,示例如下:
{\"type\":\"service_account\",\"project_id\":\"你的项目ID\",...}
配置完成后需要重启所有打开的终端、代码编辑器,确保环境变量生效。
步骤3:验证环境变量读取结果
在Strapi项目的config/functions/bootstrap.js文件中临时添加调试代码,确认读取的内容完整:
module.exports = async () => { console.log('GCS_SERVICE_ACCOUNT内容:', process.env.GCS_SERVICE_ACCOUNT); // 原有逻辑保留 };
启动项目后查看终端输出的JSON内容是否完整,确认没有引号丢失、内容截断问题后删除调试代码即可。
注意事项
安装插件时需保证版本和当前Strapi版本对齐,执行安装命令为npm install strapi-provider-upload-google-cloud-storage@3.6.2,避免版本不兼容引发额外问题。
内容的提问来源于stack exchange,提问作者hahuaz
相关产品推荐
相关产品推荐

