Spring Boot应用中JavaCompiler API获取真实类路径的问题

这个问题我之前也碰到过，确实挺头疼的——因为Spring Boot的可执行Jar是嵌套结构，JVM默认只会把外层Jar当成类路径，根本不会自动识别BOOT-INF/lib下的那些依赖Jar。不过别担心，有几个靠谱的方案可以解决：

Spring Boot本身就有处理嵌套Jar的机制，它的Archive API可以直接遍历BOOT-INF/lib下的所有依赖Jar，不用自己手动解析Jar结构，省心又可靠。

import org.springframework.boot.loader.archive.Archive;
import org.springframework.boot.loader.archive.JarFileArchive;
import java.io.File;
import java.net.URL;
import java.util.ArrayList;
import java.util.List;

public class BootClassPathHelper {
    public static List<URL> getFullClassPath() throws Exception {
        List<URL> classPathUrls = new ArrayList<>();
        
        // 获取当前可执行Jar的路径
        String jarPath = new File(
            BootClassPathHelper.class.getProtectionDomain().getCodeSource().getLocation().toURI()
        ).getPath();
        Archive appArchive = new JarFileArchive(new File(jarPath));
        
        // 遍历所有嵌套归档，筛选BOOT-INF/lib下的Jar文件
        for (Archive.Entry entry : appArchive.getEntries()) {
            if (entry.isDirectory()) {
                continue;
            }
            if (entry.getName().startsWith("BOOT-INF/lib/") && entry.getName().endsWith(".jar")) {
                // 获取嵌套Jar的URL，Spring Boot会帮我们处理好特殊的Jar URL格式
                URL nestedJarUrl = ((Archive.NestedArchiveEntry) entry).getArchive().getUrl();
                classPathUrls.add(nestedJarUrl);
            }
        }
        
        // 别忘了加上当前应用的BOOT-INF/classes目录（自己写的代码都在这里）
        URL classesUrl = new URL("jar:" + appArchive.getUrl() + "!/BOOT-INF/classes/");
        classPathUrls.add(classesUrl);
        
        return classPathUrls;
    }
}

注意：这个方法依赖spring-boot-loader包，但你的可执行Jar本身已经包含这个类了，所以不需要额外引入依赖。

如果不想依赖Spring Boot的特定API，也可以用JDK自带的JarFile来手动解析外层Jar，找出BOOT-INF/lib下的所有依赖Jar，然后构造对应的嵌套Jar URL。

import java.io.File;
import java.net.URL;
import java.util.ArrayList;
import java.util.Enumeration;
import java.util.List;
import java.util.jar.JarEntry;
import java.util.jar.JarFile;

public class ManualClassPathParser {
    public static List<URL> getFullClassPath() throws Exception {
        List<URL> classPathUrls = new ArrayList<>();
        
        // 获取当前可执行Jar的URL
        URL appJarUrl = ManualClassPathParser.class.getProtectionDomain().getCodeSource().getLocation();
        String appJarPath = appJarUrl.toURI().getPath();
        
        // 打开外层Jar，遍历所有条目
        try (JarFile jarFile = new JarFile(appJarPath)) {
            Enumeration<JarEntry> entries = jarFile.entries();
            while (entries.hasMoreElements()) {
                JarEntry entry = entries.nextElement();
                // 筛选出BOOT-INF/lib下的非目录Jar文件
                if (!entry.isDirectory() && entry.getName().startsWith("BOOT-INF/lib/") && entry.getName().endsWith(".jar")) {
                    // 构造嵌套Jar的URL，格式为：jar:file:/path/to/app.jar!/BOOT-INF/lib/dependency.jar
                    URL nestedJarUrl = new URL("jar:" + appJarUrl + "!/" + entry.getName());
                    classPathUrls.add(nestedJarUrl);
                }
            }
            
            // 添加BOOT-INF/classes目录
            URL classesUrl = new URL("jar:" + appJarUrl + "!/BOOT-INF/classes/");
            classPathUrls.add(classesUrl);
        }
        
        return classPathUrls;
    }
}

这个方案完全用JDK API实现，没有额外依赖，但需要自己处理Jar文件的关闭（用try-with-resources确保资源释放）。

拿到所有依赖Jar的URL后，你需要把它们转换成JavaCompiler能识别的类路径格式，然后传递给StandardJavaFileManager：

import javax.tools.JavaCompiler;
import javax.tools.ToolProvider;
import java.io.File;
import java.util.List;
import java.util.stream.Collectors;

public class CompilerUsage {
    public static void main(String[] args) throws Exception {
        // 用上面任意一个方法获取完整类路径URL列表
        List<URL> classPathUrls = BootClassPathHelper.getFullClassPath();
        
        // 把URL列表转换成类路径字符串（Windows用分号;，Linux用冒号:分隔）
        String classPathStr = classPathUrls.stream()
                .map(URL::getPath)
                .collect(Collectors.joining(File.pathSeparator));
        
        // 获取JavaCompiler实例
        JavaCompiler compiler = ToolProvider.getSystemJavaCompiler();
        
        // 设置文件管理器的类路径
        try (var fileManager = compiler.getStandardFileManager(null, null, null)) {
            // 把类路径字符串转换成File列表，传给文件管理器
            fileManager.setLocation(
                javax.tools.StandardLocation.CLASS_PATH,
                List.of(new File(classPathStr.split(File.pathSeparator)))
            );
            
            // 接下来就可以正常执行编译逻辑了...
        }
    }
}

• 开发环境适配：如果你的应用是在IDE中直接运行（不是打包成可执行Jar），上面的方法就不适用了。此时你可以判断当前是否运行在Jar中，然后切换成普通的类路径获取方式：

  public static boolean isRunningFromJar() {
      return BootClassPathHelper.class.getResource("BootClassPathHelper.class").toString().startsWith("jar:");
  }
  

• 嵌套Jar URL格式：构造的嵌套Jar URL是JVM支持的特殊格式（jar:外层JarURL!/内层Jar路径），JavaCompiler可以正常识别，不用担心兼容性问题。

内容的提问来源于stack exchange，提问作者Daniyar