Ubuntu Java配置常见问题

Ubuntu Java配置常见问题与排查清单

一 环境确认与基础检查

• 区分运行时与开发工具：运行用 JRE，编译与开发需要 JDK（检查命令：java -version 与 javac -version）。
• 查看实际可执行文件路径：which java、readlink -f $(which java)，确认是否来自期望的 /usr/lib/jvm/ 目录。
• 列出系统已注册的 Java 版本：sudo update-alternatives --config java；必要时为 javac 也执行 alternatives 配置。
• 核对安装目录：ls /usr/lib/jvm，常见路径形如 java-11-openjdk-amd64。
• 若提示未安装，可先 sudo apt update，再安装所需版本（如 openjdk-11-jdk）。

二 环境变量 JAVA_HOME 与 PATH 配置

• 推荐路径写法（不要带 /bin）：export JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64；export PATH=$JAVA_HOME/bin:$PATH。
• 选择配置文件：
  • 当前用户生效：~/.bashrc 或 ~/.profile；
  • 全系统生效：/etc/environment（仅放变量赋值，不要 export；生效后执行 source /etc/environment）。
• 使配置生效：source ~/.bashrc 或 source ~/.profile；如需系统级立即生效，可执行 source /etc/environment。
• 验证：echo $JAVA_HOME、java -version、javac -version 三者输出应一致且指向期望版本。

三 多版本共存与切换

• 使用系统工具管理：sudo update-alternatives --config java（必要时为 javac 单独配置），按提示选择默认版本。
• 手动注册新版本到 alternatives（示例）：
  sudo update-alternatives --install /usr/bin/java java /usr/lib/jvm/java-17-openjdk-amd64/bin/java 100
  sudo update-alternatives --install /usr/bin/javac javac /usr/lib/jvm/java-17-openjdk-amd64/bin/javac 100
• 使用 jenv 管理多版本（可选）：
  git clone https://github.com/jenv/jenv.git ~/.jenv
  echo ‘export PATH=“$HOME/.jenv/bin:$PATH”’ >> ~/.bashrc
  echo ‘eval “$(jenv init -)”’ >> ~/.bashrc
  source ~/.bashrc
  jenv add /usr/lib/jvm/java-11-openjdk-amd64
  jenv global 11.0

四 典型报错与快速修复

• “java: command not found”
  • 可能未安装或 PATH 错误。执行 sudo apt install openjdk-11-jdk（或所需版本），并核对 PATH 是否包含 $JAVA_HOME/bin。
• “javac: command not found”
  • 只装了 JRE。安装对应 -jdk 包（如 openjdk-11-jdk），并确认 alternatives 中 javac 指向 JDK。
• 版本不一致（java 与 javac 版本不同）
  • 使用 update-alternatives --config java 与 --config javac 统一版本；同时校正 JAVA_HOME 指向同一 JDK。
• “Error occurred during initialization of VM”
  • 常见于 JAVA_HOME 指向了 JRE 路径或 tools.jar/rt.jar 缺失。将 JAVA_HOME 指向 JDK 根目录（不含 /bin），必要时重装 JDK。
• 权限问题（编译/运行报 Permission denied）
  • 调整目录权限（如 chmod -R 755 项目目录），或以合适用户运行；避免无必要的 777。
• 架构不匹配（32/64 位）
  • 确认系统与 JDK 架构一致（常见为 amd64），必要时更换为匹配架构的 JDK。

五 服务与构建工具场景的配置要点

• Tomcat 9（系统服务）
  • 环境变量优先级：服务通常读取 /etc/environment 或 systemd 的环境文件；确保其中有 JAVA_HOME。
  • 启动与验证：sudo systemctl start tomcat9；浏览器访问 http://localhost:8080。
• Maven 与 Gradle
  • 确认 mvn -v 显示的 Java 版本正确；如不一致，调整 JAVA_HOME 或在构建工具中显式指定 JAVA_HOME。
• 全局与用户级配置取舍
  • 单用户开发：优先在 ~/.bashrc 或 ~/.profile 设置；
  • 多用户/生产：优先在 /etc/environment 设置，减少因登录 Shell 差异导致的不一致。