JAX-RS路径斜杠匹配问题：如何正确路由多段参数请求

这个问题我之前踩过类似的坑，核心是JAX-RS的路径匹配优先级加上正则的贪婪匹配在搞事情。咱们一步步拆解解决：

问题根源 #

你原来的类级路径@Path("/search/{searchKey}/{searchValue: .*}")里的.*是贪婪匹配模式——它会把/value1/value2/value3/details整个字符串都当成searchValue的值。这就导致带/details的请求会先匹配到无路径注解的默认方法，而不是你期望的@Path("details")方法。

解决方案 #

这里有两种靠谱的解法，你可以根据自己的代码结构选：

解法一：调整路径结构，利用匹配优先级 #

把类级别的路径简化，给两个方法分别定义更明确的路径，让JAX-RS优先匹配更具体的details路径：

@Path("/search/{searchKey}")
public class SearchResource {

    // 处理不带/details的请求：匹配任意层级的value路径
    @GET
    @Path("{searchValue: .*}")
    public Response handleDefaultRequest(
            @PathParam("searchKey") String searchKey,
            @PathParam("searchValue") String searchValue
    ) {
        // 你的业务逻辑
        return Response.ok("Default handler: " + searchKey + " | " + searchValue).build();
    }

    // 处理带/details的请求：匹配任意层级value后接/details的路径
    @GET
    @Path("{searchValue: .*}/details")
    public Response handleDetailsRequest(
            @PathParam("searchKey") String searchKey,
            @PathParam("searchValue") String searchValue
    ) {
        // 你的业务逻辑
        return Response.ok("Details handler: " + searchKey + " | " + searchValue).build();
    }
}

JAX-RS的匹配规则是更具体的路径优先，所以{searchValue: .*}/details会比{searchValue: .*}先被匹配，完美解决你的路由需求。

解法二：修改正则表达式，限制默认方法的匹配范围 #

如果你想保留原来的类级路径结构，可以给默认方法添加路径注解，用正则的负向后顾来排除以/details结尾的路径：

@Path("/search/{searchKey}")
public class SearchResource {

    // 只匹配不以/details结尾的路径
    @GET
    @Path("{searchValue: .*(?<!/details)}")
    public Response handleDefaultRequest(
            @PathParam("searchKey") String searchKey,
            @PathParam("searchValue") String searchValue
    ) {
        return Response.ok("Default handler: " + searchKey + " | " + searchValue).build();
    }

    // 匹配任意层级value后接/details的路径
    @GET
    @Path("{searchValue: .*}/details")
    public Response handleDetailsRequest(
            @PathParam("searchKey") String searchKey,
            @PathParam("searchValue") String searchValue
    ) {
        return Response.ok("Details handler: " + searchKey + " | " + searchValue).build();
    }
}

这里的(?<!/details)是负向后顾断言，确保searchValue的结尾不是/details，这样默认方法就不会抢了details方法的请求。

注意事项 #

不同的JAX-RS实现（比如Jersey、RESTEasy）对正则表达式的支持可能略有差异，写完代码后记得测试两种请求：

• baseurl.com/search/key/value1/value2/value3 应该路由到默认方法
• baseurl.com/search/key/value1/value2/value3/details 应该路由到details方法

内容的提问来源于stack exchange，提问作者Omar Andres Olivares Rodriguez