SpringBoot中如何向路径变量传递单个点(.)值

问题原因 #

当你尝试把单个.作为路径变量传递时，SpringBoot默认使用的Tomcat容器会将这类请求判定为静态资源请求，而非转发给Spring的DispatcherServlet处理。如果你的接口使用了POST/PUT等非GET方法，静态资源处理器不支持这些HTTP方法，就会返回405 Method Not Allowed错误。

解决方案 #

1. 配置Tomcat调整路径解析规则

通过修改Tomcat的配置，让它把包含单个点的路径请求交给DispatcherServlet处理，而不是当成静态资源。

方式一：通过配置类自定义Tomcat

import org.springframework.boot.web.embedded.tomcat.TomcatServletWebServerFactory;
import org.springframework.boot.web.server.WebServerFactoryCustomizer;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class TomcatPathConfig {
    @Bean
    public WebServerFactoryCustomizer<TomcatServletWebServerFactory> tomcatCustomizer() {
        return factory -> {
            factory.addConnectorCustomizers(connector -> {
                connector.setAttribute("org.apache.tomcat.util.http.parser.HttpParser.ALLOW_SEMI_COLON", true);
                connector.setAttribute("org.apache.catalina.core.StandardContext.ALLOW_EQUALS_IN_PATH", true);
            });
            // 关键：使用旧版路径解析规则，避免将单个点判定为静态资源
            factory.setPathParsing("legacy");
        };
    }
}

方式二：通过配置文件快速修改
在application.properties中添加以下配置：

# 使用旧版路径解析规则，不将单个点的路径视为静态资源
server.tomcat.path-parsing=legacy
# 允许路径中包含特殊字符
server.tomcat.allow-equals-in-path=true
server.tomcat.encoded-slash-enabled=true

2. 用正则表达式明确匹配路径变量

在@RequestMapping的路径中使用正则表达式，明确指定路径变量可以包含单个点，让Spring直接接管该请求的解析。

示例代码：

@RestController
@RequestMapping("/demo")
public class DemoController {
    // 使用正则表达式{id:.*}匹配任意字符（包括单个点）
    @GetMapping("/{id:.*}")
    public String handleSingleDotPathVariable(@PathVariable String id) {
        return "Received path variable: " + id;
    }
}

此时请求GET /demo/.会被Spring正确解析，不会触发静态资源处理器。

3. 改用请求参数传递值

如果不想修改容器配置，最简单的方式是把单个点作为请求参数传递，绕过路径变量的解析问题。

示例代码：

@RestController
@RequestMapping("/demo")
public class DemoController {
    @GetMapping("/item")
    public String handleSingleDotAsParam(@RequestParam String id) {
        return "Received parameter: " + id;
    }
}

请求URL改为GET /demo/item?id=.，即可正常接收单个点的值。

验证方法 #

用curl或Postman发送请求测试：

# 测试路径变量方式
curl http://localhost:8080/demo/.
# 测试请求参数方式
curl http://localhost:8080/demo/item?id=.

如果配置正确，会返回对应的响应内容，而非405错误。

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