1. Java未安装或版本不正确
Debian系统需先安装JDK（Java Development Kit）才能编译Java程序。可通过java -version（检查JRE）和javac -version（检查JDK）命令验证安装情况。若未安装，使用sudo apt update && sudo apt install openjdk-11-jdk（以OpenJDK 11为例）安装；若版本不兼容（如代码需Java 8但系统安装了Java 17），可通过sudo update-alternatives --config java切换默认Java版本，或卸载冲突版本后重新安装所需版本。
2. 环境变量未正确配置
JAVA_HOME（指向JDK安装路径）和PATH（包含JDK的bin目录）是编译Java的关键环境变量。若未配置，系统无法识别javac等命令。配置方法：编辑/etc/environment（全局生效）或~/.bashrc（用户级生效），添加以下内容（以OpenJDK 11为例）：
JAVA_HOME="/usr/lib/jvm/java-11-openjdk-amd64"
PATH="$JAVA_HOME/bin:$PATH"
保存后运行source /etc/environment（或source ~/.bashrc）使更改生效。
3. 编译命令错误
基础编译命令为javac 文件名.java（如javac HelloWorld.java）。常见错误包括：遗漏.java后缀（如javac HelloWorld）、路径错误（如文件不在当前目录且未指定路径，需用javac /path/to/HelloWorld.java）。需确保命令格式正确且文件路径无误。
4. 依赖库缺失
若代码依赖外部库（如MySQL驱动、第三方工具库），需在编译时通过-cp（或-classpath）选项指定库的路径。例如，依赖lib/example.jar时，命令为javac -cp .:lib/example.jar YourJavaFile.java（.表示当前目录，:分隔多个路径）。对于Maven/Gradle项目，需在pom.xml（Maven）或build.gradle（Gradle）中添加依赖，再运行mvn compile（Maven）或gradle build（Gradle）自动下载并管理依赖。
5. 编码问题
若源代码包含非ASCII字符（如中文注释、字符串），需在编译时指定字符编码（推荐UTF-8），避免乱码错误。命令为javac -encoding UTF-8 HelloWorld.java。需确保源代码文件保存时也使用UTF-8编码（可通过文本编辑器设置）。
6. 文件名与类名不匹配
Java要求公共类（public class）的类名必须与文件名完全一致（包括大小写）。例如，公共类HelloWorld必须保存为HelloWorld.java，若文件名为helloWorld.java，编译时会报错“类HelloWorld必须在文件HelloWorld.java中”。需检查并修正文件名与类名的一致性。
7. 多个Java版本冲突
若系统中安装了多个Java版本（如OpenJDK 8与OpenJDK 11），可能导致java/javac命令指向错误版本。使用sudo update-alternatives --config java和sudo update-alternatives --config javac命令选择默认版本，或通过修改PATH环境变量（将所需版本的bin目录放在前面）调整优先级。
8. JDK安装不完整或损坏
若JDK安装过程中出现网络中断、磁盘空间不足等问题，可能导致javac命令无法使用或编译失败。解决方法是重新安装JDK：sudo apt update && sudo apt install --reinstall default-jdk（恢复默认JDK）或sudo apt install --reinstall openjdk-11-jdk（恢复指定版本）。
