Spring RestController/MockMvc整数入参兼容Postman与测试的问题

你不需要修改原接口的@RequestParam注解，只需要调整MockMvc测试代码的参数传递方式，就能同时兼容Postman调用和MockMvc测试。

核心原因 #

@RequestParam接收的是请求参数（URL的query参数、POST表单参数），而你之前用requestAttr("signalId", 1)设置的是请求属性（request.getAttribute()能获取的值），两者不是同一类型的参数，所以会返回400错误。

正确的MockMvc测试写法 #

保持原接口不变：

@PostMapping("/handleSignal")
public ResponseEntity<Object> handleSignal(@RequestParam @NotNull Integer signalId)

修改MockMvc测试代码，用param()方法传递请求参数：

mockMvc.perform(post("/handleSignal")
        .param("signalId", "1") // 传递请求参数，对应@RequestParam
        .contentType(MediaType.APPLICATION_FORM_URLENCODED_VALUE)) // 可选，适用于表单提交场景
        .andExpect(status().isOk());

如果是通过URL query参数传递（比如POST请求带?signalId=1），上面的写法同样适用，MockMvc会自动将param解析为query参数。

额外说明（不推荐） #

如果业务上确实需要同时支持请求参数和请求属性传递，可通过非强制注解兼容，但会增加接口复杂度：

@PostMapping("/handleSignal")
public ResponseEntity<Object> handleSignal(
        @RequestParam(required = false) Integer signalIdParam,
        @RequestAttribute(required = false) Integer signalIdAttr) {
    // 合并参数，优先取其中一个
    Integer signalId = signalIdParam != null ? signalIdParam : signalIdAttr;
    // 后续业务逻辑
}

建议优先采用调整MockMvc测试代码的方案，保持接口符合REST规范。

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