使用Fastlane构建React Native iOS应用时遇会话过期认证错误求助

可能原因 #

• CI/CD环境无法复用Xcode本地认证会话：手动在Xcode登录的会话仅存储在当前用户本地上下文，CI脚本通常以独立无交互用户运行，无法直接调用该会话。
• 未为Fastlane配置2FA专用会话：Apple ID开启2FA后，Fastlane需要单独的会话凭证，而非依赖Xcode登录状态。
• CI环境密钥链权限受限：Fastlane需访问密钥链存储认证信息，CI环境的权限限制可能导致会话无法读取或保存。

解决办法 #

1. 生成Fastlane 2FA专用会话 #

• 本地终端执行fastlane spaceauth，按提示输入Apple ID和2FA验证码，获取会话字符串。
• 在CI环境中设置环境变量FASTLANE_SESSION，值为上述会话字符串（会话有效期约30天，到期需重新生成）。

2. 配置App Store Connect API密钥（长期稳定方案） #

• 登录App Store Connect，进入「用户和访问」→「密钥」，生成带「开发者/管理员」权限的API密钥，下载.p8密钥文件。
• 在Fastlane的Appfile中添加配置：

  app_store_connect_api_key(
    key_id: "你的密钥ID",
    issuer_id: "你的Issuer ID",
    key_filepath: "./AuthKey_XXX.p8",
    duration: 1200,
    in_house: false # 企业账号设为true
  )
  

• 将.p8文件上传至CI环境安全存储，确保Fastlane可访问该文件路径。

3. 修复CI环境密钥链权限 #

• 主流CI平台（如GitHub Actions、GitLab CI）需配置密钥链解锁权限，示例GitHub Actions步骤：

  - name: Unlock Keychain
    run: |
      security unlock-keychain -p ${{ secrets.KEYCHAIN_PASSWORD }} login.keychain-db
  

• 避免用sudo执行Fastlane，防止切换用户上下文导致认证信息无法读取。

4. 重置Fastlane本地缓存（本地调试CI脚本时用） #

• 执行fastlane reset_login清除本地认证缓存，重新配置会话或API密钥。

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