从其他分支推送到GitLab时出现无效凭证字符串错误

问题分析 #

从非主分支推送代码触发CI时，出现Error: The provided credentials string is neither valid JSON nor a valid file path.错误，但主分支正常，核心原因大概率是CI变量权限限制或脚本中的文件名笔误。

解决步骤 #

1. 修正脚本中的文件名笔误 #

查看你的.gitlab-ci.yml的before_script部分：

- echo $SERVICEACCOUNT | base64 -d > ./creds/serviceaamccount.json
- export GOOGLE_APPLICATION_CREDENTIALS="./creds/serviceaccount.json"

这里生成的文件名是serviceaamccount.json（多了一个字母a），但环境变量指向的是serviceaccount.json，导致实际需要的凭证文件不存在。把生成文件的命令改成：

- echo $SERVICEACCOUNT | base64 -d > ./creds/serviceaccount.json

2. 检查GitLab CI变量的分支可见性 #

主分支能正常获取凭证，说明SERVICEACCOUNT变量本身是有效的，但非主分支可能无权访问：

• 进入项目的「Settings」→「CI/CD」→「Variables」，找到SERVICEACCOUNT变量
• 如果变量勾选了Protected（受保护），那么只有标记为「保护分支」的分支（比如主分支）才能读取该变量，非保护分支会获取到空值或无效内容
• 解决：如果需要非主分支也能运行CI，取消该变量的「Protected」勾选；或者将你的开发分支设置为保护分支（仅适用于重要分支）

3. 验证变量有效性（可选） #

如果上述步骤无效，可以在非主分支的CI脚本中临时添加调试命令（验证后移除）：

# 在before_script里添加
- echo "SERVICEACCOUNT变量长度: ${#SERVICEACCOUNT}"
- cat ./creds/serviceaccount.json

通过输出确认变量是否有值、解码后的文件是否为有效的GCP服务账号JSON格式。

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