brew install openjdk 默认安装 openjdk@21(截至2024年中),路径为/opt/homebrew/opt/openjdk@21/libexec/openjdk.jdk,需手动设JAVA_HOME并用/usr/libexec/java_home -v 21注册生效。

brew install openjdk 会安装哪个版本?
Homebrew 默认安装的 openjdk 是最新稳定版(通常是 LTS 或次新 LTS),比如目前是 openjdk@21。它不会安装系统自带的 /usr/bin/java 对应的 Apple JDK,也不会自动软链接到 /usr/local/bin/java。
关键点在于:Homebrew 安装的 JDK 是“孤立”的,不参与 macOS 的 java_home 自动发现,除非你手动配置。
- 运行
brew install openjdk实际触发的是openjdk@21(截至 2024 年中) - 安装路径类似:
/opt/homebrew/opt/openjdk@21/libexec/openjdk.jdk(Apple Silicon)或/usr/local/opt/openjdk@21/libexec/openjdk.jdk(Intel) -
brew link openjdk@21不会执行成功 —— Homebrew 明确禁止自动 link JDK,避免覆盖系统行为
如何让 java -version 和 mvn 正确识别 Homebrew JDK?
必须手动设置 JAVA_HOME,否则 java 命令仍可能调用系统默认(甚至报错“no Java runtime present”)。
推荐做法是写入 shell 配置(~/.zshrc 或 ~/.zprofile),并使用 /usr/libexec/java_home 动态定位:
立即学习“Java免费学习笔记(深入)”;
export JAVA_HOME=$(/usr/libexec/java_home -v 21) export PATH=$JAVA_HOME/bin:$PATH
注意:/usr/libexec/java_home -v 21 能识别 Homebrew 安装的 JDK,前提是该 JDK 已被 macOS 的 Java Config 框架注册 —— Homebrew openjdk@21 安装后会自动执行注册脚本(在 post_install 中调用 sudo /usr/libexec/PlistBuddy 写入 /Library/Java/JavaVirtualMachines/ 下的 plist),所以通常开箱可用。
- 验证是否生效:
echo $JAVA_HOME应输出类似/opt/homebrew/Cellar/openjdk@21/21.0.3/libexec/openjdk.jdk/Contents/Home - Maven、Gradle、IntelliJ 都依赖
JAVA_HOME或PATH中的java,设好后无需额外配置 - 如果
java_home -v 21找不到,检查ls /Library/Java/JavaVirtualMachines/是否有openjdk-21.jdk目录;没有则需手动 symlink 或重装
同时管理多个 JDK(如 17 + 21)时怎么切换?
靠 /usr/libexec/java_home 切换最可靠,不要手动改 JAVA_HOME 硬编码路径。
猫宁Morning公益商城是中国公益性在线电子商城,以商城B2C模式运营的公益在线商城,是一家致力于将传统公益商城互联网化的创新公益商城。该网上商城系统分为电子商城系统、公益商城系统、后台管理系统,使用Maven对项目进行模块化管理,搭建多模块企业级项目。Morning是在Spring Framework基础上搭建的一个Java基础开发平台,以Spring MVC为模型视图控制器,MyBatis为
可以定义快捷函数写进 ~/.zshrc:
jdk() {
version=$1
export JAVA_HOME=$(/usr/libexec/java_home -v "$version")
export PATH=$JAVA_HOME/bin:$PATH
java -version
}
然后终端里直接运行:jdk 17 或 jdk 21 即可即时切换。
-
java_home -V(大写 V)列出所有已注册 JDK,包括 Homebrew 和 SDKMAN! 安装的(只要注册过) - Homebrew JDK 注册名通常是
openjdk-21.jdk,对应版本字符串为21,不是21.0.3 - 不同 JDK 的
javac版本和java运行时行为可能不一致,尤其涉及--enable-preview或SecurityManager移除等特性
为什么 javac 编译正常但运行时报 NoClassDefFoundError?
常见于未正确设置 JAVA_HOME 导致编译与运行用了不同 JDK —— 比如 javac 来自 Homebrew JDK,而 java 命令仍指向旧版或系统 stub。
排查步骤:
- 分别运行
which java和which javac,确认二者路径前缀一致(都应在$JAVA_HOME/bin下) - 运行
java -XshowSettings:properties -version 2>&1 | grep java.home,看实际加载的java.home是否与$JAVA_HOME一致 - 如果用 IDE(如 IntelliJ),它可能忽略 shell 的
JAVA_HOME,需在Preferences → Build → Gradle/Compiler → Java Compiler中显式指定 Project SDK
Homebrew JDK 默认启用 --illegal-access=permit(仅限 JDK 17),但 JDK 21 已彻底移除反射非法访问支持,这类错误更易暴露底层依赖问题。









