如何通过OCPSoft Rewrite自动将原始URL重定向至美化URL？

当然可以用OCPSoft Rewrite原生实现这种301永久重定向，完全不需要额外写Faces Filter的反向规则，把所有逻辑集中在Rewrite的配置里就行。下面是对应你需求的具体规则实现：

核心思路 #

通过Rewrite的规则匹配原始的/index.xhtml路径，根据查询参数的存在情况构造目标URL，并返回301 Moved Permanently状态码，既解决SEO重复内容问题，又保持代码简洁。

具体规则实现 #

假设你使用的是Rewrite的Java配置方式（实现ConfigurationProvider接口），可以这样写：

public class UrlRewriteConfig implements ConfigurationProvider {
    @Override
    public Configuration getConfiguration(ServletContext context) {
        return ConfigurationBuilder.begin()
            // 规则1：匹配 /index.xhtml 重定向到 /
            .addRule()
                .when(Direction.isInbound().and(Path.matches("/index.xhtml")).and(QueryParam.exists().not()))
                .perform(Redirect.temporary("/").withStatusCode(301))
            
            // 规则2：匹配 /index.xhtml?category=XXX 重定向到 /c/XXX（不带其他参数）
            .addRule()
                .when(Direction.isInbound().and(Path.matches("/index.xhtml")).and(QueryParam.matches("category").value().matches(".*")))
                .perform(Redirect.temporary("/c/{category}").withStatusCode(301))
            
            // 规则3：匹配带category和其他参数的情况，保留额外查询参数
            .addRule()
                .when(Direction.isInbound().and(Path.matches("/index.xhtml")).and(QueryParam.matches("category").exists()))
                .perform(
                    Redirect.temporary("/c/{category}?" + QueryParam.allExcept("category").format())
                        .withStatusCode(301)
                );
    }
}

规则解释 #

• 规则1：专门匹配不带任何查询参数的/index.xhtml，直接重定向到根路径/，避免和规则2、3冲突。
• 规则2：匹配仅带有category参数的/index.xhtml，提取参数值后重定向到/c/{category}。
• 规则3：匹配带有category和其他额外参数的情况，用QueryParam.allExcept("category")保留除category外的所有查询参数，拼接到目标URL后面。

关键优势 #

1. 集中管理：所有重定向逻辑都在Rewrite配置里，不用分散到Filter中，维护更方便。
2. 原生支持：Rewrite内置了参数提取、查询参数处理的API，不用自己手动解析HttpServletRequest，减少冗余代码。
3. 状态码控制：直接通过withStatusCode(301)指定永久重定向，符合SEO要求。

注意事项 #

• 规则的顺序很重要：把更精确的规则（比如不带参数的规则1）放在前面，避免被更宽泛的规则提前匹配。
• 如果你用的是Rewrite的XML配置方式，也可以对应转换成XML格式的规则，逻辑是一致的。

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