GitHub Actions中Fastlane构建iOS项目报错：找不到'isa'键类名

问题场景 #

本地Mac使用Fastlane构建iOS项目完全正常，但在GitHub Actions的macos-14 runner上执行xcodebuild -resolvePackageDependencies时失败，报错：

xcodebuild: error: Unable to read project 'WSSiOS.xcodeproj' from folder '/Users/runner/work/WSS-iOS/WSS-iOS/WSSiOS'.
Reason: The project ‘WSSiOS’ is damaged and cannot be opened. Examine the project file for invalid edits or unresolved source control conflicts.
Exception: didn't find classname for 'isa' key

本地执行plutil -lint WSSiOS/WSSiOS.xcodeproj/project.pbxproj返回OK，仅CI环境出现问题。

针对性解决步骤 #

1. 确认项目路径与工作目录匹配 #

• 检查GitHub Actions中Run Fastlane (internal)步骤的工作目录是否正确：当前配置working-directory: ${{ github.workspace }}，结合报错路径，确认项目文件实际位置是${{ github.workspace }}/WSSiOS/WSSiOS.xcodeproj
• 查看Fastfile的debug lane，确保xcodebuild或gym动作指定了正确的项目路径，例如：

  gym(
    project: "WSSiOS/WSSiOS.xcodeproj",
    # 其他参数...
  )
  

2. 统一Git换行符配置 #

Git的换行符转换可能导致project.pbxproj文件出现隐形格式问题，本地兼容但CI环境解析失败：

• 在仓库根目录添加.gitattributes文件，内容：

  *.pbxproj text eol=lf
  

• 提交该文件后重新触发CI，确保项目文件在runner上保持与本地一致的换行符。

3. 对齐本地与CI的Xcode版本 #

当前CI使用Xcode 15.0，确认本地开发环境是否使用相同版本：

• 若本地用旧版Xcode，打开项目后用Xcode 15重新保存一次project.pbxproj，提交更新后的文件。新版Xcode会规范项目文件的格式，避免旧格式在新环境下的解析问题。

4. 强制干净checkout代码 #

GitHub Actions可能残留缓存文件，导致项目文件损坏：

• 修改Checkout Repository步骤，添加clean: true参数：

  - name: Checkout Repository
    uses: actions/checkout@v4
    with:
      path: .
      clean: true
  

5. 检查项目文件的isa字段完整性 #

虽然plutil -lint通过，但xcodebuild对isa字段的校验更严格：

• 用文本编辑器打开project.pbxproj，搜索所有isa =条目，确保每个条目都有对应的类名（如PBXProject、PBXGroup等），没有空值或拼写错误。
• 若发现异常条目，修复后提交，或直接用Xcode重新生成项目文件（右键项目文件 -> 显示包内容 -> 删除project.pbxproj，然后用Xcode重新打开项目，会自动生成新的文件）。

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