Eclipse Oxygen运行Arquillian单元测试失败：Wildfly 8.2迁移至12问题

这个问题我之前帮同事排查过，核心原因是Apache HttpClient版本冲突导致的类加载异常，而且Eclipse的类路径处理逻辑和Maven命令行不一致，才会出现「命令行测试正常、IDE里全部失败」的诡异情况。下面是具体的排查和解决步骤：

1. 修复Maven依赖冲突（最关键） #

Wildfly 12自带了Apache HttpClient 4.5.x版本的模块，如果你的项目或者Arquillian扩展依赖了不同版本的HttpClient，就会导致类加载时出现版本不一致的问题——Eclipse可能优先加载了项目依赖的旧版本HttpClient，而这个版本的SSLConnectionSocketFactory类里没有INSTANCE字段。

解决方法：在pom.xml中，把所有HttpClient相关的依赖（比如httpclient、httpcore）的scope设置为provided，让容器提供这些类，避免打包到测试包中：

<dependency>
    <groupId>org.apache.httpcomponents</groupId>
    <artifactId>httpclient</artifactId>
    <version>4.5.13</version> <!-- 版本和Wildfly 12自带的保持一致 -->
    <scope>provided</scope>
</dependency>
<dependency>
    <groupId>org.apache.httpcomponents</groupId>
    <artifactId>httpcore</artifactId>
    <version>4.4.14</version>
    <scope>provided</scope>
</dependency>

如果使用了Arquillian Rest Client扩展，也要确保它的版本和Wildfly 12兼容，建议通过Arquillian BOM来统一管理版本：

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.jboss.arquillian</groupId>
            <artifactId>arquillian-bom</artifactId>
            <version>1.4.1.Final</version>
            <scope>import</scope>
            <type>pom</type>
        </dependency>
        <dependency>
            <groupId>org.wildfly.arquillian</groupId>
            <artifactId>wildfly-arquillian-container-managed</artifactId>
            <version>2.2.0.Final</version>
            <scope>test</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

2. 调整Eclipse的类路径优先级 #

Eclipse有时候会把项目依赖的jar放在容器模块之前加载，导致旧版本的HttpClient类被优先加载。你可以通过以下步骤调整：

• 打开Arquillian测试的Run Configuration
• 切换到Classpath标签页
• 找到User Entries下的HttpClient相关jar，把它们移到Bootstrap Entries（Wildfly容器模块）的后面
• 或者直接移除这些jar，因为我们已经设置了provided scope，容器会提供

3. 清理Eclipse缓存和重新构建 #

Eclipse的Maven缓存有时候会导致依赖不更新，执行以下操作：

• 右键项目 → Maven → Update Project...，勾选Force Update of Snapshots/Releases
• 顶部菜单 → Project → Clean...，选择你的项目进行清理
• 重新执行Maven Install，然后再运行Arquillian测试

4. 验证Wildfly容器模块 #

确认Wildfly 12的modules/system/layers/base/org/apache/httpclient目录下的模块配置没有被修改过，如果有自定义的HttpClient模块，建议恢复成Wildfly默认的配置，避免和容器自带的版本冲突。

错误原因补充 #

java.lang.NoSuchFieldError: INSTANCE这个错误本质是类加载时，JVM找到了SSLConnectionSocketFactory类，但这个类的字节码里没有预期的INSTANCE静态字段——通常是因为类路径中存在两个不同版本的HttpClient jar，一个版本有这个字段（比如4.5+），另一个没有（比如4.3及以下），而Eclipse的类路径顺序导致加载了旧版本的类，Maven命令行的类路径顺序则正确加载了容器提供的新版本类。

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