如何检查URL查询参数名与@RequestParam参数名的大小写敏感匹配

当前遇到的问题：URL查询参数使用Status=COMPLETED，但控制器方法中@RequestParam(name="status")会匹配到该参数，期望实现严格的大小写敏感匹配——仅当URL参数名为status时才会被控制器接收，Status或其他大小写变体不匹配。

项目环境：纯Spring项目（不含Spring Boot、Hibernate）

解决方案步骤 #

1. 显式指定@RequestParam的name属性 #

确保控制器方法中@RequestParam显式声明name="status"，避免依赖参数名自动推断（即使编译时未保留参数名，显式配置也能保证匹配规则明确）：

@GetMapping(value = "/foo")
@ResponseStatus(code = HttpStatus.OK)
public void getSomething(@RequestParam(name="status") Optional<Enum[]> status) {
    // 业务逻辑
}

2. 移除自定义参数名大小写转换逻辑 #

检查项目中是否存在以下自定义处理，若有则移除：

• 自定义ServletRequestParameterPropertyValues实现，将参数名转为小写/大写
• 自定义WebBindingInitializer或PropertyEditor，对参数名进行大小写转换

这些自定义逻辑会破坏Spring默认的参数名大小写敏感匹配规则。

3. 配置Spring MVC保持默认参数绑定逻辑 #

如果使用XML配置Spring MVC，确保RequestMappingHandlerAdapter使用默认的WebBindingInitializer，不添加参数名转换配置：

<bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter">
    <property name="webBindingInitializer">
        <bean class="org.springframework.web.bind.support.ConfigurableWebBindingInitializer">
            <!-- 不设置自定义属性编辑器，保持默认的参数名严格匹配 -->
        </bean>
    </property>
</bean>

如果使用Java配置，实现WebMvcConfigurer时不修改参数绑定的默认逻辑：

@Configuration
public class WebMvcConfiguration implements WebMvcConfigurer {
    @Override
    public void configureWebBinding(WebBindingInitializer initializer) {
        // 保留默认绑定逻辑，不添加参数名大小写转换操作
    }
}

4. 确认Servlet容器配置 #

确保所用Servlet容器（如Tomcat）未开启参数名大小写不敏感处理。Tomcat默认是区分参数名大小写的，无需额外配置；若有自定义容器配置，需检查是否存在relaxedQueryChars或类似参数名转换的设置。

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