Spring Boot文件上传失败：MultipartFile resource [plan]无法解析为绝对路径

问题排查与解决方案 #

1. 检查@Transient注解包路径

确认你实体类上plan字段加的@Transient是JPA规范的注解：

• 如果你用的Spring Boot 2.x版本，导包应该是javax.persistence.Transient
• 如果你用的Spring Boot 3.x版本，导包应该是jakarta.persistence.Transient
  如果导成了其他包（比如Spring的org.springframework.transaction.annotation.Transient），JPA不会识别这个注解，仍然会尝试把plan字段持久化到数据库，序列化MultipartFile对象的时候就会抛出这个路径解析错误。

2. 排除序列化问题

你Controller层会把保存后的Projet对象直接返回给前端，Spring MVC会用Jackson序列化该对象，MultipartFile类型的字段无法被序列化，也会触发同类错误。可以在plan字段上增加@JsonIgnore注解，避免Jackson序列化该字段。

3. 临时兜底方案

在调用projetRepository.save(projet)之前，手动清空plan字段：

projet.setPlan(null);
return projetRepository.save(projet);

你已经完成了文件存储逻辑，实体中的MultipartFile对象已经没有业务作用，直接清空后可以完全避免该字段带来的持久化、序列化错误。

4. 推荐优化方案

不要把MultipartFile类型的属性放到持久化实体类中，这不符合分层规范。调整Controller层的参数接收逻辑：

@PostMapping(value = "/projets", consumes = {MediaType.APPLICATION_JSON_VALUE, MediaType.MULTIPART_FORM_DATA_VALUE})
public ResponseEntity<Projet> getProjet(@ModelAttribute Projet projet, @RequestParam("plan") MultipartFile plan) throws IOException {
    log.info("Create a new project");
    Projet addedProjet = projetService.createProjet(projet, plan);
    return new ResponseEntity<>(addedProjet, HttpStatus.CREATED);
}

业务层存储文件后，只需要把文件的存储路径保存到Projet实体的对应字段即可，完全避免MultipartFile和持久化实体耦合。

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