使用Thymeleaf+Spring@ModelAttribute上传文件出现500错误求助

API 探路者

2026-8-2

问题原因与解决方案

核心问题：错误的校验注解

你的CreateReleasePackageDTO中对MultipartFile字段使用了@NotEmpty注解，这个注解仅适用于字符串、集合等类型，无法正确校验MultipartFile对象。当表单提交包含文件的请求时，Spring无法完成参数绑定流程，直接返回500错误，导致控制器端点根本不会被触发。

修复步骤

修正DTO的校验注解
将file字段的@NotEmpty替换为@NotNull，确保文件对象不为null；如果需要校验文件是否为空（即未选择文件或文件大小为0），可以添加自定义校验逻辑，或者在控制器中手动判断：

@Getter
@Setter
public class CreateReleasePackageDTO
{
    @NotNull(message = "{NotNull.releasePackageId}")
    private int releasePackageId;

    @NotEmpty(message = "{NotEmpty.nomenclature}")
    private String nomenclature;

    @NotNull(message = "{NotNull.multipartFile}") // 替换@NotEmpty为@NotNull
    private MultipartFile file;
}

添加文件空内容校验（可选但推荐）
在控制器方法中，增加对文件是否为空的判断，结合BindingResult返回错误提示：

@PostMapping("/new")
public String createReleasePackage(@ModelAttribute("package") CreateReleasePackageDTO releasePackageDTO, BindingResult result, RedirectAttributes attributes)
{
    // 校验文件是否为空（未选择文件或文件大小为0）
    if (releasePackageDTO.getFile() != null && releasePackageDTO.getFile().isEmpty()) {
        result.rejectValue("file", "NotEmpty.multipartFile", "请选择要上传的文件");
    }
    
    if (result.hasErrors())
    {
        return "new-release";
    }
    
    String response = "a response";
    System.out.println(releasePackageDTO.getReleasePackageId() + releasePackageDTO.getNomenclature() + releasePackageDTO.getFile());
    attributes.addFlashAttribute("message", response);
    return "redirect:/release";
}