使用MockBukkit#mock()抛出NPE问题求助及解决方案咨询

问题重现 #

调用MockBukkit.mock()时触发空指针异常，堆栈信息如下：

java.lang.NullPointerException: Cannot invoke "org.eclipse.aether.RepositorySystem.newLocalRepositoryManager(org.eclipse.aether.RepositorySystemSession, org.eclipse.aether.repository.LocalRepository)" because "this.repository" is null
    at org.bukkit.plugin.java.LibraryLoader.<init>(LibraryLoader.java:59)
    at org.bukkit.plugin.java.JavaPluginLoader.<init>(JavaPluginLoader.java:73)
    at be.seeseemelk.mockbukkit.plugin.PluginManagerMock.<init>(PluginManagerMock.java:90)
    at be.seeseemelk.mockbukkit.ServerMock.<init>(ServerMock.java:166)
    at be.seeseemelk.mockbukkit.MockBukkit.mock(MockBukkit.java:56)

测试代码示例：

@BeforeAll
public void setUp() {
    MockBukkit.mock();
}

该问题对应MockBukkit仓库的Issue#614，目前处于待办状态，以下是几种可行的临时解决/替代方案：

方案1：降级MockBukkit版本 #

此问题是特定版本MockBukkit与Spigot依赖的Aether组件兼容冲突导致的。可以将MockBukkit降级到已知无该问题的稳定版本，例如1.19.4-R0.1-SNAPSHOT：

修改pom.xml中的MockBukkit依赖版本：

<dependency>
    <groupId>be.seeseemelk</groupId>
    <artifactId>MockBukkit-v1.20</artifactId>
    <version>1.19.4-R0.1-SNAPSHOT</version>
    <scope>test</scope>
</dependency>

方案2：手动注入RepositorySystem依赖 #

在测试初始化前，手动初始化Aether的RepositorySystem实例并注入到Bukkit的内部上下文：

import org.eclipse.aether.DefaultRepositorySystem;
import org.eclipse.aether.RepositorySystem;
import org.eclipse.aether.connector.basic.BasicRepositoryConnectorFactory;
import org.eclipse.aether.transport.file.FileTransporterFactory;
import org.eclipse.aether.transport.http.HttpTransporterFactory;
import java.util.List;
import java.lang.reflect.Field;

@BeforeAll
public void setUp() throws NoSuchFieldException, IllegalAccessException {
    // 初始化Aether仓库系统
    RepositorySystem repositorySystem = new DefaultRepositorySystem();
    repositorySystem.setRepositoryConnectorFactories(List.of(new BasicRepositoryConnectorFactory()));
    repositorySystem.setTransporterFactories(List.of(new FileTransporterFactory(), new HttpTransporterFactory()));
    
    // 通过反射注入到LibraryLoader的静态字段
    Field repoField = org.bukkit.plugin.java.LibraryLoader.class.getDeclaredField("repository");
    repoField.setAccessible(true);
    repoField.set(null, repositorySystem);
    
    // 初始化MockBukkit
    MockBukkit.mock();
}

注意：反射方案依赖Bukkit内部实现，后续版本可能失效，仅作为临时应急方案。

方案3：使用替代测试框架 #

若MockBukkit的问题长期未修复，可考虑更换测试框架：

• PowerMock + Mockito：直接Mock Bukkit核心类，无需完整模拟服务器环境
• Paper-Test：Paper官方提供的测试工具，适配Paper插件的测试场景

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