Multipart表单请求无法到达Spring Controller问题求助

• 检查Multipart配置：确保Spring容器中存在MultipartResolver Bean，比如默认的CommonsMultipartResolver或Spring Boot自动配置的StandardServletMultipartResolver。可通过添加配置类或确认application.properties中相关配置（如spring.servlet.multipart.enabled=true、spring.servlet.multipart.max-file-size等）是否正确。

• 核对请求参数与注解匹配：

  • 你的Controller使用@RequestPart("file")，需确认请求表单字段名确实为file（从截图看字段名无误，仍需排查拼写错误）。
  • 路径变量{id}要保证请求URL中的数值是合法Long类型，比如/123/logo而非/abc/logo。可临时移除@PathVariable参数，测试请求能否进入Controller。

• 开启请求日志调试：在application.properties中添加日志配置，打印完整请求细节：

  logging.level.org.springframework.web=DEBUG
  logging.level.org.springframework.web.servlet.mvc.method.annotation=TRACE
  

  查看日志中RequestMappingHandlerMapping的请求路径匹配结果，或是否存在参数绑定失败的隐式日志。

• 排查拦截器/过滤器影响：即使请求到达所有过滤器，也要确认过滤器是否读取了MultipartHttpServletRequest的内容，导致后续无法解析。可临时禁用非必要过滤器，测试请求能否进入Controller。

• 测试简化版请求：

  • 用curl发送最简请求，排除Postman配置问题：

    curl -X POST -F "file=@/本地logo文件路径.png" http://localhost:8080/{id}/logo
    

  • 简化Controller方法，逐步添加参数排查：

    @RequestMapping(value = "/{id}/logo", method = RequestMethod.POST, consumes = MediaType.MULTIPART_FORM_DATA_VALUE)
    public void uploadPhoto(@PathVariable Long id) {
        System.out.println("进入Controller，ID：" + id);
    }
    

    观察控制台是否有输出，再逐步加回MultipartFile参数。

• 检查全局异常处理器：若存在@ControllerAdvice类，确认是否捕获了MultipartException或绑定异常但未打印日志。可临时注释全局异常处理器，查看是否出现报错信息。

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