Codemagic iOS构建签名时APP_STORE_CONNECT_PRIVATE_KEY无效如何解决

该报错由APP_STORE_CONNECT_PRIVATE_KEY环境变量格式不符合Codemagic校验规则导致，按以下步骤修正即可：

• 取消手动base64编码操作
  Codemagic会自动识别原始私钥格式，无需手动对私钥内容做base64编码，编码后的内容反而无法通过校验。
• 确保私钥内容完整
  完整复制从App Store Connect下载的.p8密钥文件的全部内容，包括开头的-----BEGIN PRIVATE KEY-----和结尾的-----END PRIVATE KEY-----标记行，以及中间所有内容的原始换行格式，不要仅复制中间的密钥字符串。
• 确认环境变量配置正确
  1. 进入Codemagic项目后台的「环境变量」设置页，找到你配置的store变量组
  2. 新增/编辑变量APP_STORE_CONNECT_PRIVATE_KEY，直接粘贴完整的p8文件内容作为变量值
  3. 勾选「Secure」（敏感变量加密存储）和「Expose to builds」（构建过程可读取）选项后保存
  4. 检查剩余三个App Store Connect相关变量的名称拼写、值是否正确，所有变量名称大小写敏感，必须和要求完全一致。
• （可选）yaml硬编码特殊处理
  如果你需要直接在codemagic.yaml中写入该变量（不推荐，存在密钥泄露风险），才需要对完整p8内容做base64编码，且变量需按以下格式书写：

  APP_STORE_CONNECT_PRIVATE_KEY: !env_var "你的base64编码结果"
  

• 排查密钥有效性
  确认对应App Store Connect密钥未被删除、且关联的账号拥有App Manager及以上权限，权限不足也会触发格式校验报错。

修正配置后重新运行工作流即可正常拉取签名文件。

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