需先用uname -m确认系统架构（x86_64/aarch64/i686），再下载匹配的JDK 17+ tar.gz包；解压至/opt/后，正确配置JAVA_HOME和PATH（$JAVA_HOME/bin必须前置），source /etc/profile，并用which、readlink -f、echo三命令验证生效。
确认系统架构和JDK版本是否匹配
CentOS 7/8 默认是 x86_64 架构，但有些老机器或容器环境可能是 aarch64（ARM）或 i386（32位），直接下载错版本会导致 bash: ./jdk-xx: cannot execute binary file: Exec format error。别急着解压，先跑一句：uname -m 看输出。常见结果有 x86_64、aarch64、i686 —— 下载 JDK 时必须严格对应。
OpenJDK 官方推荐用 yum 或 dnf 装，但要注意：CentOS 7 自带的 java-1.8.0-openjdk 是旧版（如 1.8.0_292），而很多 Spring Boot 3+ 项目需要 Java 17+。所以得自己装新版本，别迷信系统仓库。
- Oracle JDK 已停止免费商用，不建议用于生产环境
- 推荐用
temurin-17-jdk（Eclipse Temurin）或zulu-17-jdk，开源、更新勤、兼容好 - 下载 tar.gz 包（不是 rpm），因为 rpm 会强制装到
/usr/java，权限和路径容易和已有环境冲突
解压后配置 JAVA_HOME 和 PATH 的正确顺序
很多人把 JAVA_HOME 指向 /opt/jdk-17.0.1 就完事，但实际运行时仍报 java: command not found，问题出在 PATH 没生效或顺序错了。关键点：shell 启动时只读一次 /etc/profile 或 ~/.bashrc，改完必须 source，且 PATH 中 $JAVA_HOME/bin 必须放在靠前位置，否则可能被系统自带的 /usr/bin/java 覆盖。
- 解压命令用
tar -xzf jdk-17.0.1_linux-x64_bin.tar.gz -C /opt/，不要加--strip-components=1除非你确定目录结构干净 - 写入
/etc/profile时，用export JAVA_HOME=/opt/jdk-17.0.1，注意路径末尾不能有斜杠 -
export PATH=$JAVA_HOME/bin:$PATH——$JAVA_HOME/bin必须在$PATH前面，否则无效 - 改完执行
source /etc/profile，再开新终端也得重新 source，别信“重启就生效”
验证安装是否真正生效的三个命令
只跑 java -version 不够，它可能调的是软链接或 wrapper 脚本，掩盖真实路径。必须三步连查：
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
立即学习“Java免费学习笔记（深入）”；
-
which java—— 看输出是不是/opt/jdk-17.0.1/bin/java -
readlink -f $(which java)—— 排除软链接干扰，确认最终二进制文件位置 -
echo $JAVA_HOME—— 确保变量值准确，且没有空格或换行符混入（常见于复制粘贴导致的不可见字符）
如果 which java 输出 /usr/bin/java，说明 PATH 没生效；如果 readlink 指向 /etc/alternatives/java，说明系统还在走 alternatives 机制，得手动切换：sudo alternatives --config java。
多 JDK 共存时避免 alternatives 自动接管
CentOS 默认启用 alternatives 管理多个 Java 版本，但它的优先级逻辑和 PATH 冲突，尤其当你用脚本启动服务（比如 Tomcat）时，它可能绕过你的 PATH 直接调用 alternatives 配置的版本。
- 查看当前状态：
sudo alternatives --display java - 若不需要 alternatives 管理，直接移除注册：
sudo alternatives --remove java /opt/jdk-17.0.1/bin/java - 更稳妥的做法：不注册 alternatives，所有服务都显式指定
JAVA_HOME，比如 Tomcat 的setenv.sh里写export JAVA_HOME=/opt/jdk-17.0.1 - 注意：
alternatives修改会影响全局，包括 root 用户，切勿在生产环境随意--config
最常被忽略的是 shell 初始化顺序：/etc/profile → /etc/profile.d/*.sh → ~/.bashrc，如果某处重复定义了 JAVA_HOME，后面会覆盖前面，debug 时得逐个检查。
