寻求JBoss EAP 8的Arquillian测试迁移指南及成功经验

官方适配要点 #

• 容器适配器版本匹配：必须使用适配WildFly 28的arquillian-wildfly-container系列依赖，推荐使用3.0.0.Final及以上版本，版本号需与WildFly主版本兼容。
• API包路径迁移：EAP 8基于Jakarta EE 10，需将测试代码中所有javax.*包的导入替换为jakarta.*，比如javax.inject.Inject改为jakarta.inject.Inject，涉及的扩展依赖（如Arquillian Persistence）也需同步升级到支持Jakarta的版本。
• 容器配置调整：检查arquillian.xml中的容器参数，EAP 8的部分配置项命名、默认值与EAP7不同，比如管理接口的认证配置需确保managementUser和managementPassword与EAP8的默认安全配置匹配。

社区已验证的迁移步骤 #

已有开发者完成同类迁移，核心操作包括：

1. 统一依赖版本：升级所有Arquillian相关依赖到支持Jakarta EE 10的版本，示例Maven配置：

   <dependency>
       <groupId>org.jboss.arquillian.container</groupId>
       <artifactId>arquillian-wildfly-managed</artifactId>
       <version>3.0.1.Final</version>
       <scope>test</scope>
   </dependency>
   <dependency>
       <groupId>org.jboss.arquillian.junit</groupId>
       <artifactId>arquillian-junit-container</artifactId>
       <version>1.7.0.Final</version>
       <scope>test</scope>
   </dependency>
   

2. 批量替换API路径：用IDE全局替换功能将测试代码中的javax替换为jakarta，同时检查persistence.xml等配置文件中的命名空间，确保从Java EE schema切换到Jakarta EE schema。
3. 调试模糊错误：开启Arquillian调试日志，在arquillian.xml中添加<property name="serverLog">true</property>，启动容器时追加-Dorg.jboss.logging.level=DEBUG参数，通过容器启动日志定位类加载冲突、配置遗漏等问题。
4. 清理过时配置：EAP8移除了EAP7中的部分废弃子系统，需检查standalone.xml或domain.xml中的过时配置项，避免容器启动失败影响测试执行。

常见问题排查 #

• 类加载异常：若出现ClassNotFoundException，排查是否存在未替换的Java EE依赖，需排除此类依赖并替换为Jakarta EE版本。
• 容器连接失败：确认EAP8的管理端口（默认仍为9990）未被占用，且arquillian.xml中的容器地址、认证信息配置正确。

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