使用OcpSoft Rewrite时URL重写参数重复多次的问题排查

嘿，这个问题我之前帮人排查过好几次，是OcpSoft Rewrite里Join规则的默认行为坑了你——根源在于路径参数的自动传递逻辑和占位符替换的重复绑定，尤其是{url}这种可能匹配多级路径的通配符，很容易触发多次参数添加，你看到的16次就是这么来的。

问题原因拆解 #

Rewrite的Join规则默认会做两件事：

• 捕获路径中的{vendor}和{url}参数，自动把它们添加到请求的参数列表里；
• 用捕获到的参数替换目标路径/vendors/{url}里的占位符。

当{url}匹配的是包含斜杠的多级路径（比如a/b/c/d）时，Rewrite内部的路径解析逻辑会多次遍历路径片段，每一次遍历都可能重复添加url参数，最终就出现了参数重复N次的情况。

解决方案 #

这里有几种靠谱的解决办法，根据你的需求选：

1. 彻底禁止自动传递路径参数

如果转发后不需要把vendor或url作为请求参数（只是用它们来拼接目标路径），直接关闭自动参数传递即可：

@Override 
public Configuration getConfiguration(ServletContext servletContext) {
    return ConfigurationBuilder.begin().addRule(
        Join.path("/x/{vendor}/{url}")
            .to("/vendors/{url}")
            .setParameterHandling(ParameterHandling.DISCARD) // 关键：丢弃自动添加的路径参数
    );
}

ParameterHandling.DISCARD会告诉Rewrite只完成路径转发，不要把捕获到的路径参数附加到请求参数列表里，从根源上解决重复问题。

2. 手动指定需要传递的参数

如果确实需要把vendor作为请求参数传递，但不想让url重复，就手动绑定需要的参数，同时关闭自动传递：

@Override 
public Configuration getConfiguration(ServletContext servletContext) {
    return ConfigurationBuilder.begin().addRule(
        Join.path("/x/{vendor}/{url}")
            .to("/vendors/{url}")
            .addParameter("vendor", "{vendor}") // 手动传递vendor参数
            .setParameterHandling(ParameterHandling.DISCARD)
    );
}

这样请求参数里只会有你手动添加的vendor，不会出现重复的url或vendor。

3. 限制{url}的匹配范围（可选）

如果你的url本来就只需要匹配单级路径（不包含斜杠），可以把匹配规则改得更精确，避免Rewrite解析多级路径时的重复绑定：

@Override 
public Configuration getConfiguration(ServletContext servletContext) {
    return ConfigurationBuilder.begin().addRule(
        // 用[^/]+限制url只能匹配单级路径
        Join.path("/x/{vendor}/{url:[^/]+}")
            .to("/vendors/{url}")
    );
}

不过这个方法只适用于单级路径的场景，如果需要支持多级路径，还是前两种方法更稳妥。

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