Ubuntu 下 Java 程序无法启动的排查与修复
一 快速自检清单
- 确认 Java 可用：运行 java -version、javac -version；若提示 java: command not found，先安装 JDK（如：sudo apt update && sudo apt install default-jdk 或 openjdk-11-jdk）。
- 核对 JAR 路径与权限：确保 JAR 存在且可读，执行 ls -l /path/to/app.jar；必要时 chmod +x /path/to/app.jar，并以正确用户运行。
- 检查环境变量：执行 echo $JAVA_HOME、echo $PATH；若未设置，先定位安装路径（如 update-alternatives --config java），再在 ~/.bashrc 或 /etc/profile 中设置并 source 使其生效。
- 查看应用日志：优先看应用日志（如 tail -f /path/to/application.log），很多启动失败原因（配置、依赖、端口占用）都会在这里直接体现。
二 常见报错与对应处理
| 错误信息或现象 |
可能原因 |
处理要点 |
| java: command not found |
未安装 Java 或未加入 PATH |
安装 OpenJDK；用 update-alternatives --config java 确认路径；设置 JAVA_HOME 与 PATH 并生效 |
| Error: Unable to access jarfile xxx.jar |
JAR 路径错误或文件不可读 |
用 ls -l 校验路径与权限；使用绝对路径启动 |
| Error: Could not find or load main class |
主类不存在、CLASSPATH 错误、打包问题 |
核对主类全名；检查打包是否包含主类；必要时显式指定 -cp |
| UnsupportedClassVersionError |
编译与运行 JDK 版本不一致 |
统一 JDK 版本（如项目用 Java 8，运行也用 Java 8） |
| NoClassDefFoundError: javafx/… |
缺少 JavaFX |
安装 OpenJFX 或将 JavaFX 加入模块路径/类路径 |
| Permission denied |
权限不足 |
chmod +x 授予可执行权限；检查运行用户对目录与文件的读写权限 |
| 启动脚本在开机自启时失败 |
环境变量未加载 |
在脚本开头 source /etc/profile 或使用系统级环境变量 |
| 端口被占用导致启动失败 |
其他进程占用端口 |
用 **ss -tulpen |
三 环境与自启动相关要点
- 设置 JAVA_HOME 与 PATH：在 ~/.bashrc 或 /etc/profile 中添加（示例）
- export JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64
- export PATH=$JAVA_HOME/bin:$PATH
修改后执行 source ~/.bashrc 或 source /etc/profile 使其生效。
- 开机自启动脚本务必显式加载环境：在脚本首行加入 source /etc/profile，再执行 java -jar your-app.jar，避免因登录会话环境差异导致找不到 Java。
四 日志与进一步定位
- 应用日志优先：确认日志框架（如 Log4j/Logback/java.util.logging），在配置中临时将级别调为 DEBUG，并输出到控制台与文件，便于捕获首次初始化异常。
- 系统层面线索：查看 /var/log/syslog 或 /var/log/messages 是否有 OOM、磁盘满、权限拒绝等系统事件。
- JVM 诊断参数：启动时加上 -Xms 与 -Xmx 合理分配堆内存，必要时添加 -XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=/path 生成堆转储，配合 VisualVM/JProfiler 或 Eclipse MAT 分析内存问题。
- 远程调试：使用 -Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=n,address=5005 远程附加调试器，定位初始化阶段问题。
五 一键排查命令示例
- 查看与安装 Java：
- java -version || sudo apt update && sudo apt install -y default-jdk
- 定位 Java 安装路径：
- update-alternatives --config java
- 校验 JAR 与权限：
- ls -l /path/to/app.jar && chmod +x /path/to/app.jar
- 设置环境变量并生效：
- echo ‘export JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64’ >> ~/.bashrc
- echo ‘export PATH=$JAVA_HOME/bin:$PATH’ >> ~/.bashrc
- source ~/.bashrc
- 启动并跟踪日志：
- java -jar /path/to/app.jar & tail -f /path/to/application.log
- 端口占用检查：
- 远程调试启动：
- java -Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=n,address=5005 -jar /path/to/app.jar