SpigotMC插件中URLClassLoader加载子类时出现NoClassDefFoundError

我来帮你分析下问题根源，再给出针对性的解决方案：

问题根源 #

Bukkit/Spigot的插件系统采用类加载器隔离机制，每个插件都有独立的类加载器，默认情况下不同插件的类无法互相访问。你的TestService继承了microservices.jar插件中的Service基类，但你用来加载TestService的URLClassLoader默认父加载器是线程上下文类加载器，它没有权限访问microservices.jar里的Service类，这就导致加载TestService时找不到父类，抛出NoClassDefFoundError。

之前你把API打包进TestService.jar无效，是因为同一个类被不同类加载器加载会被视为不同的类型，反而会引发类型不匹配的问题。

解决方案 #

核心思路是让加载TestService的类加载器以microservices.jar的类加载器作为父类，这样就能正确加载Service基类。

1. 修改ServiceLoader代码 #

直接获取microservices.jar的类加载器（通过Service类的类加载器），并将其作为URLClassLoader的父加载器：

package me.microservices.app;

import me.microservices.api.Service;
import java.io.File;
import java.net.URL;
import java.net.URLClassLoader;
import java.util.Arrays;

public class ServiceLoader {
    public ServiceLoader() {
        File servicesDir = new File(getDataFolder().getPath() + "/services");
        File[] serviceFiles = servicesDir.listFiles();
        
        if (serviceFiles == null) {
            System.out.println("No service jars found in services directory");
            return;
        }

        URL[] urls = new URL[serviceFiles.length];
        for (int i = 0; i < serviceFiles.length; i++) {
            try {
                urls[i] = serviceFiles[i].toURI().toURL();
            } catch (Exception e) {
                e.printStackTrace();
            }
        }

        // 获取microservices插件的类加载器（Service类属于这个插件）
        ClassLoader microservicesClassLoader = Service.class.getClassLoader();
        // 用该类加载器作为父类初始化URLClassLoader
        URLClassLoader serviceClassLoader = new URLClassLoader(urls, microservicesClassLoader);

        try {
            Class<?> testServiceClass = Class.forName("me.test.TestService", true, serviceClassLoader);
            // 静态方法调用时，invoke的第一个参数传null（静态方法不依赖实例）
            testServiceClass.getMethod("execute", String.class).invoke(null, "This is a certified hood classic!!!");
        } catch (Exception e) {
            e.printStackTrace();
        }
    }

    // 替换为你插件实际的getDataFolder逻辑
    private File getDataFolder() {
        return new File("plugins/Microservices");
    }
}

2. 清理TestService.jar中的重复类 #

删除TestService.jar里的me.microservices.api.Service类，避免类加载冲突。现在我们依赖microservices.jar中的Service类，保证类型一致性。

3. 确保插件加载顺序（可选） #

如果microservices.jar是独立Bukkit插件，在其plugin.yml中设置load: STARTUP，确保它在服务jar加载前启动：

name: Microservices
main: me.microservices.app.MainPlugin
version: 1.0
load: STARTUP

额外提示 #

你之前调用静态方法execute时传了this作为第一个参数，虽然Java允许这种写法，但规范上静态方法的invoke应该传null，因为静态方法不依赖实例对象，修改后能避免潜在问题。

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