使用Fastlane从GitHub Actions上传TestFlight遇JSON解析错误求助

云原生阿岚

2026-6-16

GitHub Actions + Fastlane上传TestFlight JSON解析错误解决方案

核心问题定位

你遇到的问题根源是api.json文件包含JSON规范不允许的内容（比如注释），Fastlane解析该文件时，会将注释识别为非法Token，导致报错。

清理api.json文件：彻底移除文件内所有注释（包括//单行注释、/* */多行注释），JSON本身不支持注释语法，任何非标准结构都会触发解析错误。最终文件需是纯JSON结构，示例：
```
{
  "key_id": "你的Key ID",
  "issuer_id": "你的Issuer ID",
  "key": "-----BEGIN PRIVATE KEY-----\n你的私钥内容\n-----END PRIVATE KEY-----"
}
```
正确配置GitHub Secrets传递密钥：
1. 在GitHub仓库的Settings→Secrets and variables→Actions中，添加名为APP_STORE_CONNECT_API_KEY的密钥，内容为上述纯JSON文本。
2. 在Workflow YML文件中引用该密钥作为环境变量，避免硬编码或生成带注释的文件：
```
- name: 执行Fastlane上传
  env:
    APP_STORE_CONNECT_API_KEY: ${{ secrets.APP_STORE_CONNECT_API_KEY }}
  run: fastlane upload_to_testflight
```
验证JSON合法性：本地执行python -m json.tool api.json命令，检查文件是否符合JSON规范，若有错误会直接提示位置。
修正Base64编码用法：如果用Base64存储密钥，解码后必须确保输出是纯JSON，无额外换行或注释。解码命令示例：
```
echo ${{ secrets.APP_STORE_API_KEY_BASE64 }} | base64 --decode > api.json
```
解码后立即用JSON工具校验文件。