离线安装jdk前必须确认系统架构、清除旧java残留、核对jdk包名后缀;java_home须指向jdk根目录且配置生效;离线推荐硬链接法管理java命令,避免alternatives依赖问题。

离线安装JDK前必须确认的三个检查项
没网络时,JDK安装失败八成不是解压问题,而是环境或包本身不匹配。先做这三件事:
- 用
uname -m确认系统架构(aarch64和x86_64不能混用) - 查已有 Java 是否残留:
which java、ls -l /usr/bin/java、readlink -f /usr/bin/java—— 软链接可能指向旧版本java-11-openjdk,干扰新 JDK 生效 - 核对下载的 JDK 包名是否含
linux-x64_bin.tar.gz(Oracle)或linux-x64.tar.gz(Eclipse Temurin),带rpm或deb后缀的包在离线环境无法安装,除非你有对应包管理器缓存
解压后 JAVA_HOME 指向哪里才真正生效
解压只是第一步,JAVA_HOME 必须指向 JDK 根目录,且不能是 jre 子目录,否则 javac 找不到、java -version 显示版本但构建工具报错。
- 正确路径示例:
/opt/jdk-17.0.2(含bin/java、lib、conf目录) - 错误路径示例:
/opt/jdk-17.0.2/jre或/opt/jdk-17.0.2/bin - 设环境变量别只改
~/.bashrc:生产环境通常用/etc/profile.d/java.sh(需.sh后缀且可执行),避免 root 和普通用户行为不一致 - 验证命令:
echo $JAVA_HOME+$JAVA_HOME/bin/java -version,缺一不可
update-alternatives 在离线环境的替代方案
很多文档教用 update-alternatives --install 管理多版本 Java,但它依赖 dpkg 数据库,在无网络且未预装 deb 包的 CentOS/RHEL 上会报 no alternatives database 错误。
- 纯离线推荐硬链接法:
sudo ln -sf /opt/jdk-17.0.2/bin/* /usr/local/bin/(注意:仅限单版本,且确保/usr/local/bin在$PATH前置位) - 若需切换版本,直接改
/usr/local/bin/java软链接目标,比维护 alternatives 更可控 - 警惕
/usr/bin/java是由alternatives生成的,强行覆盖会被下次系统更新重置
Java 应用启动失败时最常忽略的两个点
即使 java -version 正常,Spring Boot 或 Tomcat 仍可能报 UnsupportedClassVersionError 或找不到 tools.jar —— 这不是配置问题,是 JDK 包选错了。
立即学习“Java免费学习笔记(深入)”;
- OpenJDK 构建版(如 Eclipse Temurin)默认不含
tools.jar,但老版本 Maven 插件(如maven-compiler-plugin )会硬依赖它;解决方案:升级插件,或改用 Oracle JDK(含 <code>lib/tools.jar) -
UnsupportedClassVersionError: Unsupported major.minor version 61.0表示编译用 JDK 17,运行用 JDK 11 —— 离线环境里容易把不同版本的java和javac混用,务必统一$JAVA_HOME/bin下所有命令来源
离线环境没有包管理器兜底,每个路径、每个软链接、每个 $PATH 顺序都得手动对齐,差一个字符就可能让应用卡在 classpath 加载阶段。










