使用fastlane上传iOS应用至App Store/TestFlight时遇Unexpected token -错误

排查步骤 #

1. 验证IPA文件合法性 #

• 使用Apple官方工具验证IPA是否符合上传要求：

  xcrun altool --validate-app -f /path/to/your/app.ipa -t ios --apiKey <你的API密钥> --apiIssuer <Issuer ID>
  

• 手动检查IPA包：将IPA后缀改为.zip解压，查看Payload/YourApp.app/Info.plist，确认CFBundleIdentifier、CFBundleVersion等字段与fastlane配置的app_identifier一致，且无乱码、格式错误。

2. 检查路径与变量有效性 #

• 确认所有变量赋值正确，无空值：在fastlane执行前添加echo命令输出变量，比如：

  echo "IPA路径: $ipa_directory"
  echo "API密钥路径: $APP_STORE_CONNECT_API_KEY_PATH"
  

  注意：upload_to_testflight的ipa参数需要具体IPA文件路径，而非目录。如果ipa_directory是目录，需改为ipa: "#{ipa_directory}/YourApp.ipa"这种具体路径。
• 检查metadata、screenshots变量：如果是动态生成的结构，确认其格式合法，无空字段或JSON语法错误。

3. 修复参数转义问题 #

你的命令中changelog和beta_app_review_info里的notes使用了HTML转义符"，在Ruby语法中需替换为正常双引号：

changelog: "Review our new App.",
beta_app_review_info: {
  contact_email: ENV['IOS_CONTACT_EMAIL'],
  contact_first_name: ENV['IOS_CONTACT_NAME'],
  contact_last_name: ENV['IOS_CONTACT_LAST_NAME'],
  contact_phone: ENV['IOS_CONTACT_NUMBER'],
  demo_account_name: ENV['IOS_CONTACT_DEMO_ACCOUNT_LOGIN'],
  demo_account_password: ENV['IOS_CONTACT_DEMO_ACCOUNT_PASSWORD'],
  notes: "thank you for reviewing our App"
}

4. 简化命令定位问题 #

先执行最简版本的上传命令，排除非必要参数干扰：

# 测试TestFlight上传
upload_to_testflight(
  api_key_path: APP_STORE_CONNECT_API_KEY_PATH,
  app_identifier: IOS_PRODUCTION_APP_STORE_BUNDLE_ID,
  ipa: "/path/to/your/app.ipa"
)

# 测试App Store上传
upload_to_app_store(
  api_key_path: APP_STORE_CONNECT_API_KEY_PATH,
  app_identifier: IOS_PRODUCTION_APP_STORE_BUNDLE_ID,
  ipa: "/path/to/your/app.ipa"
)

如果最简命令成功，再逐步添加原参数，定位到触发异常的具体参数。

5. 升级fastlane及依赖 #

旧版本fastlane可能存在JSON解析bug，执行以下命令升级到最新稳定版：

gem update fastlane
gem update spaceship

6. 查看详细日志 #

执行命令时添加--verbose参数获取完整日志，定位错误发生的具体阶段：

fastlane <你的lane名称> --verbose

日志会显示是在读取本地文件（metadata、IPA）还是与App Store Connect通信时出现了解析错误。

内容的提问来源于stack exchange，提问作者cld-dev