Google服务账号私钥在.NET工具部署Android应用时的环境变量问题

一、推荐方案：Base64编码/解码（彻底解决换行与掩码问题） #

之前的解码错误大概率是编码时没保留完整的私钥格式，按以下步骤操作：

1. 本地编码私钥 #

把完整的私钥字符串（包含-----BEGIN PRIVATE KEY-----、所有换行、-----END PRIVATE KEY-----）直接转成Base64：

• Linux/macOS：

  echo -n "$(cat your-service-account-key.json | jq -r '.private_key')" | base64
  

• Windows PowerShell：

  $privateKey = (Get-Content your-service-account-key.json | ConvertFrom-Json).private_key
  [Convert]::ToBase64String([Text.Encoding]::UTF8.GetBytes($privateKey))
  

  复制输出的Base64字符串，这就是你要存在环境变量里的值。

2. .NET代码中解码还原 #

读取环境变量后直接解码，还原后的格式和appsettings.json里的完全一致：

var base64Key = Environment.GetEnvironmentVariable("GOOGLE_PRIVATE_KEY_BASE64");
if (!string.IsNullOrEmpty(base64Key))
{
    var keyBytes = Convert.FromBase64String(base64Key);
    var privateKey = Encoding.UTF8.GetString(keyBytes);
    // 把privateKey传入Google API客户端的凭证配置即可
}

二、备选方案：换行符替换 #

如果不想用Base64，可将私钥里的换行符替换为\n标记，再在代码中还原：

1. 预处理私钥 #

把原始私钥的每一个换行（\n）替换成字符串\n（反斜杠+n），比如：
原始私钥：

-----BEGIN PRIVATE KEY-----
MIIEvQIBADANBgkqhkiG9w0BAQEFAASCBKcwggSjAgEAAoIBAQC...
-----END PRIVATE KEY-----

替换后变成：
-----BEGIN PRIVATE KEY-----\nMIIEvQIBADANBgkqhkiG9w0BAQEFAASCBKcwggSjAgEAAoIBAQC...\n-----END PRIVATE KEY-----

2. 代码中还原换行 #

var escapedKey = Environment.GetEnvironmentVariable("GOOGLE_PRIVATE_KEY");
if (!string.IsNullOrEmpty(escapedKey))
{
    var privateKey = escapedKey.Replace("\\n", "\n");
    // 传入Google API客户端配置
}

三、GitLab CI/CD配置注意事项 #

1. 变量掩码：Base64编码后的字符串或替换换行后的字符串都是连续无换行的，直接在GitLab项目Settings > CI/CD > Variables中添加变量，勾选Mask variable即可实现掩码。
2. 传递给Docker：在CI脚本里直接用环境变量传递，比如：

deploy:
  stage: deploy
  image: docker:latest
  script:
    - docker run 
        -e GOOGLE_TYPE=$GOOGLE_TYPE 
        -e GOOGLE_PROJECT_ID=$GOOGLE_PROJECT_ID 
        -e GOOGLE_PRIVATE_KEY_BASE64=$GOOGLE_PRIVATE_KEY_BASE64 
        your-google-play-publisher-image

四、验证步骤 #

• 在代码中临时添加日志，输出还原后的私钥（测试完立即移除，避免泄露），确认和appsettings.json里的private_key完全一致。
• 本地用docker run命令传入环境变量测试，确保认证不报错。

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