Struts 2 6.2 URL 参数映射方法

Struts 2 本身不原生支持 REST 风格的路径参数（如 /save-user.action/name/joe/age/20），但可通过前置 URL 重写过滤器（如 Tuckey URLRewriteFilter）将路径格式转换为标准查询参数格式，再交由 Struts 2 处理。

Struts 2 本身不原生支持 REST 风格的路径参数（如 `/save-user.action/name/joe/age/20`），但可通过前置 URL 重写过滤器（如 Tuckey URLRewriteFilter）将路径格式转换为标准查询参数格式，再交由 Struts 2 处理。

在 Struts 6.2（兼容 Struts 2 约定插件 convention-plugin）中，Action 默认通过 .action 后缀匹配，且参数通常以 ?key=value 查询字符串形式传入。而路径参数（path variables）如 /save-user.action/name/joe/age/20 属于 RESTful 风格，Struts 核心拦截器链无法直接解析该结构——它会在进入 StrutsPrepareAndExecuteFilter 前就因路径不匹配或参数未绑定而失败。

✅ 推荐方案：使用 Tuckey URLRewriteFilter 进行预处理
该过滤器需部署在 StrutsPrepareAndExecuteFilter 之前，实现「请求重写」而非「重定向」，确保原始请求上下文（如 HttpServletRequest）中的 request.getRequestURL() 和 getQueryString() 已被改写为 Struts 可识别的形式。

配置步骤如下：

1. 添加依赖（Maven）

   
    org.tuckey
    urlrewritefilter
    4.0.4
   

2. 配置 web.xml（注意过滤器顺序！）

   
   
    UrlRewriteFilter
    org.tuckey.web.filters.urlrewrite.UrlRewriteFilter
   
   
    UrlRewriteFilter
    /*
    REQUEST
   

3. 定义重写规则（src/main/webapp/WEB-INF/urlrewrite.xml）

   
   
   
    
    
        ^/([^.]+\.action)(?:/([^/]+)/([^/]+))*
        /$1$2=$3
    
   
    
    
        /save-user.action/name/([^/]+)/age/(\d+)
        /save-user.action?name=$1&age=$2
    
   

⚠️ 注意事项：

• 正则中使用 & 而非 &，避免 XML 解析错误；
• 若参数数量不固定，建议采用第一种通用正则 + 自定义 UrlRewriteRule 类扩展逻辑；
• 所有重写均发生在服务器端（forward），客户端无感知，不影响 Action 中 @Action 注解或 convention-plugin 的自动参数注入；
• Struts 6.2 默认启用 alwaysSelectFullNamespace，请确保命名空间与重写后 URL 匹配（如 /save-user.action 对应 namespace="" 或 /）；
• 开发阶段可启用 UrlRewriteFilter 调试日志（设置 logLevelDEBUG）验证重写是否生效。

完成配置后，请求 save-user.action/name/joe/age/20 将被静默转为 save-user.action?name=joe&age=20，Struts 2 即可正常绑定至 Action 的 name 和 age 属性（需提供对应 setter 方法），无需修改任何业务代码。此方案轻量、稳定，是 Struts 生态中处理路径参数的事实标准实践。