Wildfly中JAX-RS REST端点EJB注入与RESTEASY003020错误解决

问题根源梳理 #

你遇到的核心矛盾源于WildFly对EJB容器与JAX-RS容器的双重管理逻辑：

• 给JAX-RS控制器加@Stateless/@LocalBean后，RESTEASY引擎会因EJB的实例化拦截逻辑，无法正确解析POST请求参数，触发RESTEASY003020: Bad arguments passed错误
• 移除EJB注解后，端点恢复正常，但失去EJB容器的依赖注入能力，导致MyServiceLocal无法注入
• 将控制器移到web模块后功能正常，本质是WildFly对EAR结构中web模块与EJB模块的类加载、资源扫描规则差异导致的

正确实现方案 #

根据项目结构（单WAR/多模块EAR），分两种场景给出标准实现：

场景1：单WAR项目（所有代码打包在一个WAR中） #

这种情况下，JAX-RS控制器可同时作为EJB存在，只需确保参数绑定和注入逻辑正确：

1. 控制器类的正确注解
   同时标注JAX-RS路径注解和EJB注解，明确指定请求的媒体类型：

   @Path("/v1")
   @Stateless
   @LocalBean
   public class MyController {
   
       // 用@EJB直接注入本地服务接口
       @EJB
       private MyServiceLocal myService;
   
       @POST
       @Path("/getResponse")
       @Consumes(MediaType.APPLICATION_JSON)
       @Produces(MediaType.APPLICATION_JSON)
       // 自定义参数对象必须提供无参构造函数
       public Response getResponse(MyRequest request) {
           MyResponse response = myService.processRequest(request);
           return Response.ok(response).build();
       }
   }
   

2. JAX-RS全局配置
   创建Application子类指定根路径，WildFly会自动扫描WAR中所有带@Path的类：

   @ApplicationPath("/api")
   public class RestApplication extends Application {
       // 无需额外代码，留空即可
   }
   

3. 服务类的EJB注解
   服务实现类标注@Stateless，本地接口标注@Local：

   @Local
   public interface MyServiceLocal {
       MyResponse processRequest(MyRequest request);
   }
   
   @Stateless
   public class MyService implements MyServiceLocal {
       @Override
       public MyResponse processRequest(MyRequest request) {
           // 业务逻辑实现
           return new MyResponse("Success");
       }
   }
   

场景2：多模块EAR项目（web模块+EJB模块分离） #

这种情况下，必须将JAX-RS控制器放在web模块，EJB服务放在独立的EJB模块，避免类加载和扫描冲突：

1. EJB模块配置
   服务接口和实现类放在EJB模块（JAR）：

   @Local
   public interface MyServiceLocal {
       MyResponse processRequest(MyRequest request);
   }
   
   @Stateless
   public class MyService implements MyServiceLocal {
       @Override
       public MyResponse processRequest(MyRequest request) {
           // 业务逻辑实现
           return new MyResponse("Success");
       }
   }
   

2. web模块的控制器配置
   控制器放在web模块（WAR），通过JNDI lookup注入EJB：

   @Path("/v1")
   // 无需加EJB注解，由JAX-RS容器管理
   public class MyController {
   
       // JNDI格式：java:global/ear名称/ejb模块名称/服务类全名!接口全名
       @EJB(lookup = "java:global/MyEnterpriseApp/MyEjbModule/MyService!com.example.MyServiceLocal")
       private MyServiceLocal myService;
   
       @POST
       @Path("/getResponse")
       @Consumes(MediaType.APPLICATION_JSON)
       @Produces(MediaType.APPLICATION_JSON)
       public Response getResponse(MyRequest request) {
           MyResponse response = myService.processRequest(request);
           return Response.ok(response).build();
       }
   }
   

3. JAX-RS全局配置
   在web模块创建Application子类：

   @ApplicationPath("/api")
   public class RestApplication extends Application {
   }
   

关键注意事项 #

• 禁止在EJB模块放置JAX-RS控制器：WildFly默认只在web模块扫描JAX-RS资源，EJB模块的JAX-RS类会被双重管理，导致参数解析冲突
• 参数绑定必须明确：POST请求必须指定@Consumes，自定义参数对象必须提供无参构造函数，否则RESTEASY无法实例化参数
• 注入方式适配场景：单WAR项目用@EJB直接注入；多模块EAR项目建议用JNDI lookup，避免类加载路径问题
• 版本兼容：确保项目中javax.ws.rs依赖版本与WildFly内置的RESTEASY版本一致，避免依赖冲突

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