如何让JavaCompiler.CompilationTask通过自定义ClassLoader读取已加载的.class文件

你的思路方向是对的，但核心问题在于Java Compiler的类查找逻辑并不是直接依赖ClassLoader的loadClass/findClass方法，而是通过JavaFileManager提供的JavaFileObject实例来获取类的源码或字节码。你传入了自定义ClassLoader但没正确对接FileManager的查找流程，所以编译器根本没用到它。

下面分点拆解你的问题：

1. 思路是否存在问题？ #

思路本身没问题——增量编译的核心就是复用有效.class文件、只编译过时的.java，而让编译器能识别已加载的类字节码是关键。但你对JavaCompiler的工作机制理解有偏差：编译器不会主动调用ClassLoader的加载方法，它只认JavaFileManager提供的文件对象。你需要把自定义ClassLoader中的类字节码包装成JavaFileObject，让FileManager返回给编译器，才算完成对接。

2. 编译器能否使用.class文件替代.java文件？ #

完全可以！甚至这是增量编译的标准做法。JavaCompiler在编译时，会优先查找类的字节码（.class），如果找到的字节码版本符合要求、且对应源码不存在或已过时，就会直接使用字节码，而不会重新编译.java文件。你要做的就是让编译器能通过FileManager拿到这些.class文件的“代理”对象。

3. 具体实现技巧 #

这里给出关键的实现步骤和代码片段：

（1）基于ForwardingJavaFileManager扩展自定义FileManager #

不要从零实现JavaFileManager，而是继承ForwardingJavaFileManager复用默认实现，只重写类查找相关的方法：

public class IncrementalFileManager extends ForwardingJavaFileManager<StandardJavaFileManager> {
    private final ClassLoader customClassLoader;

    public IncrementalFileManager(StandardJavaFileManager delegate, ClassLoader classLoader) {
        super(delegate);
        this.customClassLoader = classLoader;
    }

    @Override
    public Iterable<JavaFileObject> list(Location location, String packageName, Set<JavaFileObject.Kind> kinds, boolean recurse) throws IOException {
        Iterable<JavaFileObject> defaultFiles = super.list(location, packageName, kinds, recurse);
        List<JavaFileObject> allFiles = new ArrayList<>(StreamSupport.stream(defaultFiles.spliterator(), false).toList());

        // 如果编译器需要查找类文件，从自定义ClassLoader中补充
        if (kinds.contains(JavaFileObject.Kind.CLASS)) {
            String packagePath = packageName.replace('.', '/');
            // 从ClassLoader中获取对应包下的类资源
            Enumeration<URL> classResources = customClassLoader.getResources(packagePath);
            while (classResources.hasMoreElements()) {
                URL classUrl = classResources.nextElement();
                allFiles.add(new ClassResourceFileObject(classUrl));
            }
        }

        return allFiles;
    }

    // 自定义JavaFileObject，包装ClassLoader中的类字节码
    private static class ClassResourceFileObject extends SimpleJavaFileObject {
        private final URL classUrl;

        public ClassResourceFileObject(URL url) throws URISyntaxException {
            super(url.toURI(), JavaFileObject.Kind.CLASS);
            this.classUrl = url;
        }

        @Override
        public InputStream openInputStream() throws IOException {
            return classUrl.openStream();
        }
    }
}

（2）构建编译任务时传入自定义FileManager #

获取StandardJavaFileManager后，包装成你的自定义FileManager，再传给JavaCompiler.getTask()：

JavaCompiler compiler = ToolProvider.getSystemJavaCompiler();
StandardJavaFileManager standardManager = compiler.getStandardFileManager(null, null, null);
IncrementalFileManager customManager = new IncrementalFileManager(standardManager, yourCustomClassLoader);

// 筛选需要编译的.java文件：只选无对应.class或.class过时的文件
List<File> sourceFiles = getOutdatedSourceFiles();

CompilationTask task = compiler.getTask(null, customManager, null, null, null, 
    standardManager.getJavaFileObjectsFromFiles(sourceFiles));
task.call();

（3）额外注意事项 #

• 依赖追踪：增量编译不能只看单个.java和.class的时间戳，还要考虑依赖关系——如果类A依赖的类B被修改了，即使A的.java没改，也要重新编译A。你需要维护类的依赖图谱来处理这种情况。
• 类缓存：自定义ClassLoader要维护已加载类的缓存（比如一个Map<String, Class<?>>），方便FileManager快速查找对应类的字节码。
• 字节码版本兼容：确保已加载的.class文件的版本和编译器的目标版本一致，避免编译时出现版本不兼容错误。

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