Spring Boot如何在单个@POSTMapping中实现对象与图片上传？

当然能把这两个POST接口合并成一个，核心是利用multipart/form-data请求格式，让接口同时接收业务对象和文件。

具体实现示例 #

修改接口为以下形式，通过@RequestPart同时接收PersonModel对象和图片文件：

@PostMapping("/user/uploadPersonAndImage")
public ResponseEntity<BaseResposeModel> uploadPersonAndImage(
        @RequestPart("person") PersonModel personModel,
        @RequestPart("productImage") MultipartFile file) throws Exception {
    // 执行原PersonModel上传逻辑
    personService.upload(personModel);
    // 执行原图片上传逻辑
    personImageService.uploadImage(file);
    
    BaseResposeModel response = new BaseResposeModel();
    response.setMessage(personModel.getFirstName() + " 信息及图片上传成功");
    return new ResponseEntity<>(response, HttpStatus.OK);
}

关键注意事项 #

• 请求必须以multipart/form-data作为Content-Type发送
• 前端传参时，要将PersonModel序列化为JSON字符串，作为名为person的请求部分；图片文件作为名为productImage的请求部分
• 确保项目依赖中包含Jackson相关包（Spring Boot Starter Web默认已包含），这样Spring才能自动将JSON字符串解析为PersonModel对象

如果不想用JSON传递PersonModel，也可以将对象的每个属性作为独立的表单字段传递，用@RequestParam逐个接收后构建对象，示例如下：

@PostMapping("/user/uploadPersonAndImage")
public ResponseEntity<BaseResposeModel> uploadPersonAndImage(
        @RequestParam("firstName") String firstName,
        @RequestParam("lastName") String lastName,
        // 其他PersonModel属性...
        @RequestParam("productImage") MultipartFile file) throws Exception {
    PersonModel personModel = new PersonModel();
    personModel.setFirstName(firstName);
    personModel.setLastName(lastName);
    // 设置其他属性...
    
    personService.upload(personModel);
    personImageService.uploadImage(file);
    
    BaseResposeModel response = new BaseResposeModel();
    response.setMessage(firstName + " 信息及图片上传成功");
    return new ResponseEntity<>(response, HttpStatus.OK);
}

这种方式适合属性较少的对象，属性多的话还是推荐JSON格式的@RequestPart方式。

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