macOS Big Sur下Xcode构建KMM项目运行gradlew时Java版本识别异常

• macOS 图形界面启动的应用（含Xcode）不会加载用户shell的专属配置文件：你在终端环境中配置的jenv初始化逻辑、export JAVA_HOME语句、PATH路径调整规则，全部写入~/.zshrc、~/.bash_profile、~/.zprofile这类仅对交互终端生效的配置文件，这些配置仅对终端进程及其派生的子进程可见。GUI应用启动时继承的环境变量仅来自系统launchd进程注入的全局会话配置，和终端shell的运行环境完全隔离。
• Xcode 构建子进程的环境继承规则：Xcode 执行构建脚本时，会直接将脚本作为自身的子进程拉起，子进程完全复用Xcode进程本身的环境变量，不会主动调用交互shell加载本地shell配置，因此天然拿不到你在终端里配置的Java环境参数。
• 错误Java版本的匹配逻辑：由于Xcode构建环境中没有注入JAVA_HOME，也没有执行eval "$(jenv init -)"完成jenv初始化，jenv的shim代理路径根本没有被插入到PATH最前面。Gradle启动时会按照默认查找逻辑从PATH路径中扫描可用的java可执行文件，直接定位到系统路径下之前安装的AdoptOpenJDK 1.8的可执行程序，完全绕开了你在jenv全局配置里指定的Java 11版本。你在Xcode日志里看到jenv global输出为1.8的异常表现，也是无初始化的jenv调用绕过你写入的全局版本配置导致的。

1. Xcode构建流程启动，拉起./gradlew执行:shared:packForXCode任务，子进程继承Xcode的空Java相关环境变量，无JAVA_HOME、无jenv代理配置
2. Gradle初始化阶段从PATH中扫描定位到Java 1.8作为运行时
3. Android Gradle Plugin 检测到当前运行时为Java 1.8，触发内置版本校验逻辑——AGP 7.0及以上版本强制要求运行时为Java 11，校验不通过直接终止构建，抛出版本不匹配的异常

• Xcode日志中echo $JAVA_HOME无输出，本质是Xcode环境根本没有加载你在shell配置中写入的JAVA_HOME导出语句
• 普通终端下执行相同检查命令能正常识别Java 11、正确输出JAVA_HOME，是因为终端启动时会完整加载所有shell配置文件，把jenv初始化、JAVA_HOME导出、PATH路径调整的逻辑全部执行，和Xcode的GUI进程属于两套完全独立的环境。

内容的提问来源于stack exchange，提问作者C. Hellmann