如何测试标注@Service与@Path的JAX-RS接口类？

我项目中有一个标注@Slf4j、@Service、@Path("/manageOffer")的JAX-RS接口类BffProductOfferServiceApi，其内部方法fetchOfferDetails标注了@POST、@Path("/fetchOfferDetails")等注解。使用@SpringBootTest、@AutoConfigureMockMvc编写测试用例调用该接口时返回404错误；但标注@RestController的测试类用相同测试逻辑却能正常运行。请问如何正确测试这类标注@Service与@Path的接口类？

@AutoConfigureMockMvc是Spring MVC专属的测试工具，仅能识别Spring MVC体系下的@RestController、@RequestMapping这类注解定义的端点，完全不支持JAX-RS的@Path、@POST等注解。直接用MockMvc测试JAX-RS接口，自然会因找不到匹配路径返回404。

根据你使用的JAX-RS实现（如Jersey、RESTEasy），可选择以下两种测试方式：

方式一：用TestRestTemplate/WebTestClient替代MockMvc #

这两个是Spring Boot提供的通用HTTP测试工具，能直接向启动的测试服务器发送真实HTTP请求，支持所有Web框架（包括JAX-RS）。

示例代码：

@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)
public class BffProductOfferServiceApiTest {

    @Autowired
    private TestRestTemplate testRestTemplate;

    @Test
    public void testFetchOfferDetails() {
        // 构造请求体
        OfferRequest request = new OfferRequest();
        // 设置请求参数...

        // 发送POST请求
        ResponseEntity<OfferResponse> response = testRestTemplate.postForEntity(
                "/manageOffer/fetchOfferDetails",
                request,
                OfferResponse.class
        );

        // 断言响应状态和结果
        assertEquals(HttpStatus.OK, response.getStatusCode());
        assertNotNull(response.getBody());
        // 其他断言逻辑...
    }
}

方式二：使用JAX-RS实现自带的测试框架 #

以Jersey为例，可使用JerseyTest直接启动Jersey容器测试端点，同时集成Spring上下文：

public class BffProductOfferServiceApiJerseyTest extends JerseyTest {

    @Override
    protected Application configure() {
        // 注册JAX-RS类和Spring集成组件
        ResourceConfig config = new ResourceConfig();
        config.register(BffProductOfferServiceApi.class);
        // 配置Spring上下文集成
        config.register(SpringComponentProvider.class);
        return config;
    }

    @Test
    public void testFetchOfferDetails() {
        OfferRequest request = new OfferRequest();
        // 设置参数...

        Response response = target("/manageOffer/fetchOfferDetails")
                .request(MediaType.APPLICATION_JSON)
                .post(Entity.json(request));

        assertEquals(Response.Status.OK.getStatusCode(), response.getStatus());
        OfferResponse result = response.readEntity(OfferResponse.class);
        assertNotNull(result);
    }
}

额外检查点 #

确保你的JAX-RS配置正确：

• 是否创建了标注@ApplicationPath的JAX-RS应用类，并将BffProductOfferServiceApi注册进去？示例：

  @ApplicationPath("/api")
  public class JaxRsApplication extends ResourceConfig {
      public JaxRsApplication() {
          register(BffProductOfferServiceApi.class);
      }
  }
  

  若存在该配置，测试时的请求路径需加上/api前缀，即/api/manageOffer/fetchOfferDetails。

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