Spring RestController获取图片遇400错误：getPictureById方法无法触发

首先，HTTP 400错误（请求语法不正确）的核心原因是：你的请求在到达getPictureById方法之前就被Spring的请求解析器拒绝了，所以才会出现断点不触发、日志没输出的情况——方法根本没被执行到。结合你提到getPictureById2能正常运行，我们可以从以下几个维度排查差异点：

1. 对比两个方法的@RequestMapping配置 #

先把两个方法的注解配置拉出来对比，重点看这几个点：

• 请求路径：比如getPictureById2用了@RequestMapping("/test/{id}")，而getPictureById用了@RequestMapping("/pic")，但你请求的时候用了/pic/123，这就会导致路径不匹配，Spring无法找到对应的方法，直接返回400。
• 请求方法：如果getPictureById指定了method = RequestMethod.POST，但你用GET请求访问，也会触发400（Spring 4.0.5默认不指定method的话支持所有请求方法，但指定后必须严格匹配）。
• 参数注解：这是最常见的坑！比如：
  • 你在getPictureById里用了@PathVariable("id") Long id，但请求URL是/pic?id=123（应该用/pic/123）；
  • 或者用了@RequestParam("id") Long id，但请求URL是/pic/123（应该用/pic?id=123）；
  • 甚至注解里的参数名和请求里的不一致，比如注解是@RequestParam("picId")，但请求传的是id。

2. 检查参数类型与传递方式 #

Spring 4.0.5对参数类型转换的容错性比较低：

• 如果你的方法参数是基本类型（比如long id），但请求里没传这个参数，或者传的是非数字字符串（比如abc），Spring无法完成转换，直接返回400。建议改用包装类型（Long id），这样至少没传参数时会是null，不会直接报400。
• 确认请求参数的传递是否符合方法要求：比如POST请求的body格式是否和方法接收的参数匹配（比如方法期望接收@RequestBody的JSON对象，但你传了form-data）。

3. 开启Spring DEBUG日志排查细节 #

如果上面的排查没找到问题，建议开启Spring的DEBUG级别日志，你会看到更详细的错误信息，比如：

Failed to convert value of type 'java.lang.String' to required type 'java.lang.Long'; nested exception is java.lang.NumberFormatException: For input string: "abc"

这条日志直接告诉你是参数id的类型转换失败，瞬间就能定位问题。

举个正确的示例参考 #

比如你要通过路径变量获取图片ID，正确的写法应该是：

@RequestMapping(value = "/pic/{id}", method = RequestMethod.GET)
public ResponseEntity<byte[]> getPictureById(@PathVariable("id") Long id) {
    // 你的业务逻辑
    System.out.println("处理图片ID：" + id);
    // 返回图片数据
}

对应的请求URL应该是：GET /your-app-context/pic/123

如果是通过请求参数传递ID：

@RequestMapping(value = "/pic", method = RequestMethod.GET)
public ResponseEntity<byte[]> getPictureById(@RequestParam("id") Long id) {
    // 你的业务逻辑
    System.out.println("处理图片ID：" + id);
    // 返回图片数据
}

对应的请求URL应该是：GET /your-app-context/pic?id=123

总结 #

核心思路就是：对比正常运行的getPictureById2方法，找出getPictureById在请求路径、参数注解、参数类型上的差异，因为400错误本质是请求不符合Spring的解析规则，还没到执行你方法的阶段。

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