Java 版本选哪个才能在 Mesa 系统上跑起来

Mesa 系统（通常指基于 OpenEuler / 麒麟 / 统信等国产 OS 的定制发行版）对 Java 的支持不是“装了就能用”，关键看是否提供对应架构的 JDK。x86_64 没问题，但若 Mesa 运行在鲲鹏（arm64）、飞腾（loongarch64）或海光（x86_64 兼容但需特定构建）上，jdk-17_linux-x64_bin.tar.gz 这类通用包大概率启动失败——Illegal instruction 或直接报 no such file or directory（其实是动态链接器不兼容）。

实操建议：

• 先查清 CPU 架构：uname -m，常见结果有 aarch64、loongarch64、x86_64
• 去 OpenJDK 官方镜像站（如 https://adoptium.net/）或华为毕昇 JDK、龙芯 JDK、中科软 OpenJDK 镜像，下载匹配架构的 tar.gz 包（例如 temurin-17.0.2+8-jdk_loongarch64_linux_hotspot.tar.gz）
• 避免用系统包管理器（如 yum install java-17-openjdk）一键装——国产 Mesa 系统的仓库常滞后，且可能缺 JFR、JDI 等组件，导致后续调试工具失效

JAVA_HOME 和 PATH 怎么设才不会被 systemd 或 GUI 应用忽略

在 Mesa 系统上，export JAVA_HOME=/opt/jdk-17 写进 ~/.bashrc 只影响当前终端；Java 服务（比如 Tomcat、Spring Boot 的 systemd service）或桌面应用（IDEA、Eclipse）根本读不到——它们走的是 /etc/environment 或 systemd 的 Environment= 配置。

实操建议：

• 统一用系统级配置：

  sudo tee /etc/profile.d/java.sh export JAVA_HOME=/opt/jdk-17<br>export PATH=$JAVA_HOME/bin:$PATH<br>EOF

  ，然后 source /etc/profile.d/java.sh
• 对 systemd 服务，必须显式声明：sudo systemctl edit myapp.service，写入

  [Service]<br>Environment="JAVA_HOME=/opt/jdk-17"<br>Environment="PATH=/opt/jdk-17/bin:/usr/local/bin:/usr/bin"

• GUI 应用（如 IDEA）依赖桌面环境的 session 启动脚本，需检查 /etc/X11/Xsession.d/ 或用户级 ~/.pam_environment（格式为 JAVA_HOME DEFAULT=/opt/jdk-17）

国产 JDK 常见报错：NoClassDefFoundError 与 sun.misc.Unsafe 不可用

部分国产 JDK（尤其早期毕昇或龙芯定制版）默认禁用 sun.misc.Unsafe，或未完整实现 java.lang.invoke，导致 Netty、Lombok、Hibernate 等依赖反射/字节码增强的库直接抛 NoClassDefFoundError: sun/misc/Unsafe 或 UnsupportedOperationException: sun.misc.Unsafe is not available。

java-api-doc-generator

分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。

下载

实操建议：

• 启动时加参数绕过限制：-XX:+UnlockExperimentalVMOptions -XX:+EnableUnsafe（仅限明确支持该 flag 的 JDK 版本）
• 更稳妥的做法是换用已知兼容的 JDK：华为毕昇 JDK 21+、OpenJDK 17u（龙芯社区编译版），它们默认开启 Unsafe 且通过 JCK 测试
• 验证是否生效：java -XshowSettings:properties -version 2>&1 | grep -i unsafe，看到 sun.misc.Unsafe.available=true 才算到位

为什么 jar 包运行正常，但 javac 编译报错“找不到符号”

这通常不是代码问题，而是 Mesa 系统中 javac 和 java 来自不同 JDK——比如 java -version 显示 17，但 which javac 指向系统自带的 OpenJDK 11 的 /usr/lib/jvm/java-11-openjdk-amd64/bin/javac，导致编译时用老版本语法解析，运行时用新版本 JVM 加载，类型擦除和泛型处理不一致。

实操建议：

• 确认两者同源：ls -l $(which java) $(which javac)，路径前缀必须完全一致（如都指向 /opt/jdk-17/bin/）
• 删掉冲突的旧 JDK：sudo rm -rf /usr/lib/jvm/java-11-openjdk-*（注意别误删系统关键包）
• 如果必须共存，用 update-alternatives 管理：sudo update-alternatives --install /usr/bin/java java /opt/jdk-17/bin/java 100，再 --config java 和 --config javac 同步选择

国产化适配最耗时间的往往不是装 JDK，而是确认每个进程实际加载的是哪一套 classpath、哪些 native library、以及是否被 SELinux 或国密策略拦截了 JNI 调用——这些细节不打日志、不报错，只默默静默失败。

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南