KMM项目iOS源码集在Xcode运行报错：需Java17却检测到Java11

问题根源 #

Xcode启动Gradle构建时，并未使用你系统默认的Java 17环境，而是调用了旧版本的Java（比如Java 11）——这是因为Xcode的环境变量独立于终端和Android Studio，不会自动继承你在shell中配置的Java路径。

修复步骤 #

1. 获取Java 17的安装路径 #

在终端执行命令，得到Java 17的绝对路径：
/usr/libexec/java_home -v 17
输出示例：/Library/Java/JavaVirtualMachines/openjdk-17.0.9.jdk/Contents/Home

2. 配置shell环境变量 #

根据你使用的shell（bash或zsh）编辑对应的配置文件：

• 用bash的话，执行 open ~/.bash_profile
• 用zsh的话，执行 open ~/.zshrc

在文件末尾添加以下内容，替换成你刚才获取的Java 17路径：

export JAVA_HOME=/Library/Java/JavaVirtualMachines/openjdk-17.0.9.jdk/Contents/Home
export PATH=$JAVA_HOME/bin:$PATH

保存文件后，执行 source ~/.bash_profile（bash用户）或 source ~/.zshrc（zsh用户），让配置立即生效。

3. 让Xcode读取终端的环境变量 #

Xcode默认会 sanitize 构建环境，不会读取用户的shell配置，执行以下命令关闭这个限制：
defaults write com.apple.dt.Xcode UseSanitizedBuildSystemEnvironment -bool NO

注意：执行后必须完全关闭Xcode（包括后台进程），再重新打开项目。

4. 验证Xcode中的Java版本 #

可以通过添加Run Script构建阶段来确认：

1. 在Xcode项目中，选择target -> Build Phases
2. 点击+ -> New Run Script Phase
3. 在脚本框中输入 java --version
4. 运行项目，查看控制台输出，确认显示的是Java 17版本。

5. 检查项目Gradle配置 #

打开项目根目录的gradle.properties文件，确保没有强制指定旧Java版本的配置：

# 移除或修改以下类似配置（如果存在）
# org.gradle.java.home=/path/to/java11

如果需要手动指定，改成Java 17的路径即可。

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