Debian Java报错排查与修复指南
一 快速定位与通用修复
二 常见报错对照与处理
| 症状与关键词 | 典型原因 | 处理要点 |
|---|---|---|
| java: command not found | 未装JDK或PATH未包含$JAVA_HOME/bin | 安装JDK;正确设置JAVA_HOME与PATH并source生效 |
| UnsupportedClassVersionError | 编译版本高于运行版本 | 用update-alternatives --config java切换到更高版本,或重编译为低版本 |
| NoSuchMethodError | 版本冲突、依赖不一致或IDE指向错误JDK | 统一运行与编译版本;在IDE(如VSCode)设置**“java.home”: “/usr/lib/jvm/java-11-openjdk-amd64”** |
| 编译时报错(找不到符号/包) | 未安装JDK、依赖未加入类路径 | 安装JDK;使用**-cp指定依赖,如java -cp .:/path/to/lib.jar YourMain** |
| 图形界面字体/显示错误 | 无X11环境或缺少字体 | 加**-Djava.awt.headless=true**;或安装xvfb以提供虚拟X11 |
| 安装/更新失败 | 依赖损坏或APT源异常 | 执行apt -f install、dpkg --configure -a;必要时更换为可用APT源后更新 |
三 编译与运行的最小示例
四 仍未解决时的高效求助方式