Ubuntu Java编译时依赖库缺失的排查与解决
一 先判断是哪种依赖缺失
- 出现诸如“package xxx does not exist”“cannot find symbol”，且你用的是 javac，通常是项目依赖的第三方 JAR 没在类路径里。解决：把依赖加入 -cp/-classpath。示例：javac -cp “.:/path/to/lib.jar” Your.java。若是普通应用开发，优先用 Maven/Gradle 管理依赖，能自动下载并配置类路径。
- 出现“No such file or directory”并指向 .h 头文件（如 X11/extensions/shape.h），或执行 ./configure 时报缺 X11/cups/freetype/alsa/fontconfig 等，这是编译 OpenJDK 等本地代码时的系统依赖缺失，需要安装对应的 -dev 包。
- 若是 Maven/Gradle 构建时报“依赖下载失败/校验和不匹配”，多为仓库或网络问题，检查仓库配置与网络，必要时更换镜像源或清理本地缓存后重试。
二 项目类路径缺失的处理
- 手动指定类路径：编译时把所有依赖 JAR 和源码根目录加入 -cp，Linux 下分隔符用“:”。示例：javac -cp “.:lib/" YourMain.java；运行：java -cp ".:lib/” YourMain。
- 使用构建工具：
- Maven：在 pom.xml 声明依赖并执行 mvn clean compile。
- Gradle：在 build.gradle 声明依赖并执行 gradle build。
- 设置 JAVA_HOME 与 PATH（避免用错 JRE）：例如 export JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64，export PATH=$JAVA_HOME/bin:$PATH，并写入 ~/.bashrc 或 /etc/profile 使其永久生效。
三 编译 OpenJDK 时系统依赖缺失的处理
- Ubuntu 20.04/22.04 常见组合（按需安装，通常一次装齐）：
- 图形/打印/字体：sudo apt-get install libx11-dev libxext-dev libxrender-dev libxtst-dev libxt-dev libcups2-dev libfreetype6-dev libfontconfig1-dev
- 音频：libasound2-dev
- 其他可能用到：libffi-dev autoconf
- 若是 OpenJDK 12+，还需要 Bootstrap JDK 11+：sudo apt-get install openjdk-11-jdk。
- 典型流程：bash configure 检查依赖 → 根据提示安装缺失包 → 再执行 make。configure 的输出会明确告诉你要装哪个库。
四 常见报错与对应修复
- “javac: command not found”或版本不对：sudo apt-get install openjdk-11-jdk（或所需版本），并确认 java -version / javac -version 输出一致。
- “Error occurred during initialization of VM”：检查 JAVA_HOME 是否指向 JDK 而非 JRE，并确认 $JAVA_HOME/bin 在 PATH 中。
- “package xxx does not exist”：把依赖 JAR 加入 -cp；用 Maven/Gradle 的项目执行 mvn/gradle 让其自动拉取依赖。
- “No such file or directory（指向 .h）”：安装对应的 -dev 包（如 libx11-dev 等），再重新 configure/make。
- “%s directive argument is null”等将警告视为错误的编译问题（OpenJDK 构建时偶见）：在 configure 时增加 –with-extra-cflags=-Wno-error --with-extra-cxxflags=-Wno-error 再编译。
五 快速排查清单
- 确认已安装 JDK 并正确设置 JAVA_HOME/PATH。
- 明确缺失类型：是项目 JAR（加 -cp 或用 Maven/Gradle），还是系统 -dev 库（用 apt 安装）。
- 复制完整错误行与关键上下文，优先搜索错误关键词或贴到社区求助。
- 清理并重建：删除 target/ 或 build/、*.class，再重新编译。
- 构建大型项目（如 Android 源码）内存不足时，可设置 MAVEN_OPTS=“-Xms4096m -Xmx4096m” 后再尝试。