使用Arquillian与Payara Micro 1.1连接器时遇空指针异常求助

你遇到的NullPointerException大概率是Arquillian没能成功初始化Payara Micro容器导致的——因为你用了@RunWith(Arquillian.class)，如果容器启动失败，Arquillian的测试上下文就没法正常构建，最终抛出空指针。咱们一步步来定位和修复问题：

1. 版本兼容性不匹配 #

你当前使用的arquillian-payara-micro-managed:1.1和payara.version:5.192存在版本兼容问题：

• Arquillian Payara Micro插件1.1对应的最低Payara Micro版本是5.201，而你用的5.192版本过低，会导致容器启动时出现底层兼容性错误，间接引发空指针。

修复方案：
升级Payara Micro版本到5.201（或更高的5.x稳定版），新版本修复了不少Arquillian集成的bug：

<properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <maven.compiler.source>1.8</maven.compiler.source>
    <maven.compiler.target>1.8</maven.compiler.target>
    <!-- 升级到兼容的版本 -->
    <payara.version>5.201</payara.version>
</properties>

2. 归档包缺少必要的CDI配置文件 #

你的JavaArchive只添加了HelloWorld类，但Payara Micro作为Java EE容器，需要识别归档包为合法的Java EE模块。即使是简单的测试，也需要添加beans.xml来启用CDI（Arquillian依赖CDI管理测试上下文）。

修复方案：

1. 在src/test/resources/META-INF目录下创建空的beans.xml文件（Payara Micro会自动识别并启用CDI）；
2. 修改测试类的Deployment方法，添加这个配置文件：

@Deployment
public static JavaArchive createDeployment() {
    return ShrinkWrap.create(JavaArchive.class)
            .addClass(HelloWorld.class)
            // 添加CDI配置文件
            .addAsResource("META-INF/beans.xml");
}

3. 优化Maven Surefire插件的路径配置 #

你当前的MICRO_JAR路径用了硬编码的${project.basedir}，可以换成更简洁的Maven内置变量，避免路径错误：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-surefire-plugin</artifactId>
    <version>2.22.2</version>
    <configuration>
        <environmentVariables>
            <!-- 用build目录变量替代硬编码路径 -->
            <MICRO_JAR>${project.build.directory}/payara-micro-${payara.version}.jar</MICRO_JAR>
        </environmentVariables>
    </configuration>
</plugin>

4. 验证容器启动日志（排查残留问题） #

如果按照以上步骤修复后仍有问题，运行测试时加上-X参数查看详细日志：

mvn test -X

重点查看Payara Micro启动阶段的报错信息（比如端口占用、依赖缺失），这能帮你定位更底层的问题。

完整修复后的测试类示例 #

import org.jboss.arquillian.container.test.api.Deployment;
import org.jboss.arquillian.junit.Arquillian;
import org.jboss.shrinkwrap.api.ShrinkWrap;
import org.jboss.shrinkwrap.api.spec.JavaArchive;
import org.junit.Assert;
import org.junit.Test;
import org.junit.runner.RunWith;

@RunWith(Arquillian.class)
public class HelloWorldTest {
    @Deployment
    public static JavaArchive createDeployment() {
        return ShrinkWrap.create(JavaArchive.class)
                .addClass(HelloWorld.class)
                .addAsResource("META-INF/beans.xml");
    }

    @Test
    public void sayHelloTest() {
        HelloWorld helloWorld = new HelloWorld();
        Assert.assertEquals("Hello World", helloWorld.sayHello());
    }
}

按照以上步骤调整后，你的测试应该能正常通过了。

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