必须确认系统架构与JDK版本匹配:32位(i686/i386)仅支持OpenJDK,64位(x86_64/aarch64)才可安装JDK 11+;下载包名须含x64或aarch64;解压后务必正确配置JAVA_HOME指向JDK根目录并更新PATH,否则java -version成功但javac等工具不可用。

确认Linux系统架构和JDK版本匹配
Java官方不再提供32位JDK下载,若uname -m返回i686或i386,必须改用OpenJDK或放弃Oracle JDK;64位系统(x86_64或aarch64)才可安装主流JDK 11+。JDK 17/21的tar.gz包名含x64或aarch64字样,下错会报cannot execute binary file: Exec format error。
- 查系统架构:
uname -m - 查glibc版本(影响部分JDK兼容性):
ldd --version - 推荐优先选
jdk-17.0.1_linux-x64_bin.tar.gz这类明确标出平台的包,避免用jdk-17_linux-x64_bin.rpm——RPM在非CentOS/RHEL系发行版(如Ubuntu/Debian)需额外处理依赖
解压后必须配置JAVA_HOME并更新PATH
仅解压tar.gz不等于安装完成。Java命令找不到、Maven/Gradle报Unsupported Java version,90%是JAVA_HOME未设或指向错误目录。
-
JAVA_HOME应指向JDK根目录(不是bin子目录),例如:/opt/jdk-17.0.1 - 在
/etc/profile或用户~/.bashrc中添加:export JAVA_HOME=/opt/jdk-17.0.1 export PATH=$JAVA_HOME/bin:$PATH
- 立即生效:
source ~/.bashrc(注意不是source /etc/profile,后者对当前shell无效) - 验证:
java -version和echo $JAVA_HOME必须同时输出预期结果
避免用update-alternatives管理多个JDK时的路径陷阱
当系统已装OpenJDK,再手动装Oracle JDK后执行sudo update-alternatives --config java,容易选错java软链目标——它只改/usr/bin/java,但JAVA_HOME仍指向旧路径,导致javac和构建工具行为不一致。
- 统一用
JAVA_HOME驱动所有Java工具,而非依赖update-alternatives - 若必须用
update-alternatives,需为java、javac、jar分别注册,并确保--install命令中的路径与JAVA_HOME一致 - 检查实际调用路径:
which java和readlink -f $(which java)应指向$JAVA_HOME/bin/java
验证JDK是否真正可用:不只是java -version
java -version成功不代表JDK完整就绪。常见漏检项:缺少javac(仅JRE)、keytool不可用(影响SSL调试)、java启动参数被环境变量污染。
立即学习“Java免费学习笔记(深入)”;
- 必验命令:
javac -version、keytool -list、jps - 测试编译运行小样例:
echo 'public class Test { public static void main(String[] args) { System.out.println("OK"); } }' > Test.java javac Test.java && java Test - 检查
JAVA_TOOL_OPTIONS等环境变量是否注入了非法JVM参数,会导致java命令直接退出
JAVA_HOME没生效或指向了JRE而非JDK,这两个点比下载哪个包更关键。










