解决Spring @PathVariable截取带点参数问题

"这篇文档主要讨论了在Spring框架中如何处理`@PathVariable`注解时，遇到URL路径变量中包含点号（.）导致的不完整参数问题。文档提到，当URL路径如`/param/hehe.hehe`被映射到`@PathVariable`时，Spring默认只会捕获最后一个点号前的字符串，即`hehe`，而忽略后续的`.hehe`部分。" 正文： 在Spring MVC中，`@PathVariable`注解用于从URL路径中提取参数值并注入到控制器的方法参数中。然而，在某些场景下，URL路径可能包含点号（.），例如`/param/hehe.hehe`，此时Spring默认的行为是将点号前的部分作为参数值，即`hehe`，而忽略点号后面的部分。这可能会导致在处理特定类型的ID或路径时出现问题，比如处理文件名或者版本号等场景。 文档中提到了一个背景案例，一个Spring Boot应用，其版本为2.1.4.RELEASE，Spring框架版本为5.1.6.RELEASE。在这个应用中，有一个`@RestController`类，其中定义了一个处理`/param/{param1}`的GET请求。当尝试访问`http://127.0.0.1:8080/param/hehe.hehe.hehe`时，预期接收完整的参数值`hehe.hehe.hehe`，但实际上只有`hehe.hehe`被传递给`param1`。 这个问题的原因在于Spring MVC的路径匹配策略。默认情况下，Spring MVC使用`PathMatcher`实现，它会解析URL路径中的路径元素，并且对带点的路径进行特殊处理，认为点号分隔的是不同的路径元素，因此只保留第一个元素。这种行为可以通过调整配置来改变。 解决这个问题的关键在于配置`RequestMappingHandlerMapping`的`useSuffixPatternMatch`属性。这个属性控制是否启用后缀模式匹配，如果设置为`false`，Spring将不再试图将URL中的点号视为路径元素的分隔符，而是将整个字符串视为一个完整参数。因此，可以按照以下方式修改`WebConfig`类： ```java @Configuration @Import(WebMvcAutoConfiguration.EnableWebMvcConfiguration.class) @SuppressWarnings("unchecked") public class WebConfig implements WebMvcConfigurer, WebMvcRegistrations { @Override public RequestMappingHandlerMapping getRequestMappingHandlerMapping() { RequestMappingHandlerMapping handlerMapping = new RequestMappingHandlerMapping(); handlerMapping.setUseSuffixPatternMatch(false); // 关闭后缀模式匹配 return handlerMapping; } } ``` 通过设置`useSuffixPatternMatch`为`false`，Spring将不再自动截断点号后的部分，从而能够正确地捕获到完整的`@PathVariable`参数，例如`hehe.hehe.hehe`。 需要注意的是，关闭后缀模式匹配可能会对其他依赖于此行为的URL产生影响，所以在调整此配置时应确保不会对现有功能造成破坏。此外，还应考虑是否有必要在特定的`@RequestMapping`方法或整个控制器上进行局部配置，而不是全局禁用后缀模式匹配。 要获取`@PathVariable`注解中带点的完整参数，需了解Spring MVC的路径匹配机制，并通过配置`useSuffixPatternMatch`属性来改变默认行为。这使得开发者能够更好地处理那些包含特殊字符如点号的URL路径参数。