Jersey未识别新增端点方法的问题排查及解决

我有一个运行正常的SpringBoot/JAX-RS服务，在已有端点的资源类接口中新增了一个临时端点方法，但Jersey未注册该方法，调用时返回404错误。

排查操作 #

• 实现ApplicationEventListener，在INITIALIZATION_APP_FINISHED事件处理完成后查看最终的ResourceModel；
• 注释掉一个现有端点方法，验证服务是否处理该资源类。

通过调试器查看ResourceModel，发现其中包含资源类所有已定义的端点方法，但唯独缺少新增的方法；注释现有方法后，该方法也会从ResourceModel中消失，说明新增方法的声明存在问题，但无法确定具体原因。

接口方法与声明 #

新增的接口方法声明：

@GET
@Path("/fakestatus")
@Consumes({MediaType.APPLICATION_JSON})
@Produces({MediaType.APPLICATION_JSON})
@ApiOperation(
        value = "Changes the fake health indicator status.",
        notes = "Changes the fake health indicator status.",
        response = Response.class)
public Response changeFakeHealthIndicatorStatus(@QueryParam("status") String status,
                                                @Context UriInfo uriInfo);

资源接口的声明开头：

@Api("note")
@Path("/notes")
@Produces({MediaType.APPLICATION_JSON})
public interface NoteResource {

最初该方法没有@ApiOperation、@Consumes、@Produces注解及@Context参数，我逐步添加这些配置（与服务中其他方法及同类服务配置一致），但问题仍未解决。

问题解决 #

问题并非出在接口，而是实现类中。最初实现类的代码如下：

@Override
public Response changeFakeHealthIndicatorStatus(@QueryParam("status") String status) {
    fakeHealthIndicator.setStatus(status);
    return Response.status(Status.OK).entity("Status").build();
}

关键问题在于实现方法上的@QueryParam注解——我直接从接口复制了方法签名，误以为该注解会被忽略，但实际并非如此。移除这个注解后，端点成功注册，调用不再返回404。

推测原因：Jersey在创建资源映射时，会优先识别带有参数注解（如@QueryParam）的“最底层”实现方法，但该方法上没有@GET、@Path等必要的端点注解（这些注解仅存在于接口方法上）。移除多余的@QueryParam注解后，Jersey会找到包含所有必要注解的接口方法，从而正确完成端点注册。

内容的提问来源于stack exchange，提问作者David M. Karr