JAX-RS URI模板未捕获预期字符串问题求助

我编写了一个简单的API，代码如下：

@GET
@Path("res/{res-path :.*}")
public Response getRes(@PathParam("res-path") String resource) {
   System.out.println(resource);
}

原本认为该URI模板应捕获res/之后的所有内容，但实际情况并非如此！测试情况如下：

• URL：res/res2 -----> 输出res2（符合预期）
• URL：res/res2/res3 -----> 输出res2/res3（符合预期）
• URL：res/res -----> 输出空字符串（预期应为res/）
• URL：res/res/res2 -----> 输出res2（预期应为res/res2）

请问有什么建议或思路吗？

解决方案与思路 #

这个问题的核心是JAX-RS路径匹配规则中，贪婪模式正则在处理末尾斜杠时的特殊行为，以及路径匹配的「最长匹配优先」特性。

1. 问题根源 #

当使用{res-path :.*}模板时，.*/的匹配逻辑会和潜在的精确路径模式冲突：哪怕你没显式定义@Path("res/res")这样的方法，部分JAX-RS实现会优先识别这种精确路径，导致剩余片段才会被你的正则模板捕获。另外，.*会匹配空字符串，当路径结构为res/res时，匹配器可能将res/之后的内容解析为空。

2. 修复方案 #

方案一：调整正则表达式，避免匹配歧义

用更明确的正则规则强制捕获所有后续内容，同时处理空值情况：

@GET
@Path("res/{res-path: .*}")
public Response getRes(@PathParam("res-path") String resource) {
   // 若需保留末尾斜杠，手动补全逻辑
   String targetPath = resource.isEmpty() ? "res/" : resource;
   System.out.println(targetPath);
}

方案二：用.+替代.*，避免空匹配

.+要求至少匹配一个字符，能直接避免捕获空字符串的情况：

@GET
@Path("res/{res-path: .+}")
public Response getRes(@PathParam("res-path") String resource) {
   System.out.println(resource);
}

注意：这种写法无法匹配res/（末尾带斜杠）的请求，需额外添加对应方法或处理逻辑。

方案三：通过UriInfo直接获取完整路径

完全绕过路径匹配的歧义问题，用UriInfo拿到真实请求路径后手动截取：

@GET
@Path("res/{res-path: .*}")
public Response getRes(@PathParam("res-path") String resource, @Context UriInfo uriInfo) {
   String fullPath = uriInfo.getPath().substring("res/".length());
   System.out.println(fullPath);
}

3. 额外注意事项 #

• 确认你的JAX-RS实现（如Jersey、RESTeasy）版本，不同版本的路径匹配规则可能存在差异；
• 排查是否有其他资源方法的路径与当前模板冲突，精确匹配会优先于正则模板；
• 若需处理res/这类空路径请求，需单独添加@Path("res/")的方法，或在当前方法中判断并处理空值。

内容的提问来源于stack exchange，提问作者B. A.