如何让JavaCompiler的-classpath配置在Linux环境的.java编译场景生效

• 检查文件路径与权限
  Linux路径大小写完全敏感，首先确认/home/apiJars/tools.jar的路径、文件名大小写和实际存储完全一致；其次确认运行程序的账号对tools.jar有读权限，对/home/apiJars/目录有执行权限，可执行以下命令修正权限：

  chmod +x /home/apiJars/
  chmod +r /home/apiJars/tools.jar
  

• 确认运行环境为完整JDK
  JRE默认不包含tools.jar，只有JDK才会自带该文件。在Linux服务器执行以下命令验证环境：

  java -version
  javac -version
  

  若javac命令不存在，需替换运行环境为对应版本的完整JDK。
• 修正运行时类加载配置
  你给编译参数配置的-classpath是给被编译的业务代码使用的，而JavaCompiler API本身依赖的com.sun.tools.javac相关类需要加载到你当前程序的JVM运行时类路径中，而非仅配置编译参数：
  1. 若直接运行jar包，不要使用-jar参数启动，改为显式指定classpath：

     java -cp /home/apiJars/tools.jar:你的程序包.jar 你的主类全限定名
     

  2. 若使用Tomcat等容器部署，将tools.jar放到容器的公共lib目录（如Tomcat的$CATALINA_HOME/lib/）下，避免应用类加载器隔离导致无法加载。
• 跨平台兼容优化（可选）
  不要硬编码classpath分隔符，改为调用Java系统属性自动适配不同系统：

  String pathSeparator = System.getProperty("path.separator");
  String classpath = "/home/apiJars/tools.jar" + pathSeparator + "/home/jar1" + pathSeparator + "/home/jar2";
  

• 高版本JDK适配
  如果你使用JDK9及以上版本，tools.jar已经被移除整合到了jdk.compiler模块中，无需单独引入tools.jar，只需要给运行程序的JVM添加启动参数：

  --add-modules jdk.compiler
  

内容的提问来源于stack exchange，提问作者Eric.li