Spring DispatcherServlet错误匹配url-pattern导致非预期接口命中

你遇到的非预期跨路径命中Controller的情况，是配置未实际生效+框架默认路径裁剪逻辑共同导致的，不属于框架设计上的异常bug。 #

1. 为什么不同路径都能命中同一个Controller #

Spring MVC 处理请求时，默认会对DispatcherServlet接收的请求做路径裁剪，这是导致多路径命中的核心原因：

• 当请求匹配到/api/*、/img/*这类前缀型的Servlet映射规则时，框架会自动把请求路径中匹配Servlet映射的前缀部分裁掉，用剩余的路径片段去匹配Controller上定义的接口映射。
• 对你的场景来说：
  • 请求/test：因为是精确匹配DispatcherServlet的/test映射，裁剪后剩余路径是/test，和Controller上的映射完全匹配，符合预期。
  • 请求/api/test：匹配DispatcherServlet的/api/*映射，自动裁掉前缀/api，剩余路径/test，刚好和Controller的接口映射匹配，所以会触发返回hello的逻辑。
  • 请求/img/test：匹配DispatcherServlet的/img/*映射，自动裁掉前缀/img，剩余路径/test，同样会命中同一个接口。

2. 你写的全路径配置为什么没起作用 #

你通过XML手动定义RequestMappingHandlerMapping并设置alwaysUseFullPath=true的操作，大概率没有实际效果：

• 绝大多数Spring MVC项目都会配置<mvc:annotation-driven />标签，这个标签会自动注册一个优先级更高的RequestMappingHandlerMapping实例，自动生成的实例不会读取你手动定义的bean中的配置，会把alwaysUseFullPath重置为默认值false，也就是保持之前的路径裁剪逻辑。
• 就算没有使用mvc:annotation-driven，你手动定义的bean如果没有设置最高优先级，也可能被框架内置的默认实例覆盖，导致配置失效。

修复方案 #

如果需要让框架直接用请求的完整路径匹配Controller，不再自动裁剪Servlet映射的前缀，需要把全路径匹配的配置和框架的自动配置对齐，避免被覆盖：

• XML配置场景下，把全路径匹配参数放到mvc:annotation-driven标签内部配置：

  <mvc:annotation-driven>
      <mvc:path-matching always-use-full-path="true" />
  </mvc:annotation-driven>
  

• 不要单独手动定义RequestMappingHandlerMapping的bean，这种写法很容易被框架的自动注册逻辑覆盖，导致配置不生效。
• 配置真正生效后，框架会直接用完整请求路径做匹配：/api/test、/img/test的完整路径和Controller上的/test映射完全不匹配，自然就不会再触发这个接口的逻辑；原有的/test请求因为完整路径就是/test，还是会正常命中接口，不会破坏原有预期行为。

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