Spring Boot文件上传：选择自定义异常还是自定义校验器？

问题1：自定义异常还是自定义校验器？ #

优先选择自定义校验器，更贴合Spring的校验生态，能实现校验逻辑与业务逻辑的解耦，还可以直接复用你已有的hasCsvFormat()方法，具体实现步骤如下：

1. 自定义校验注解：

@Target({ElementType.PARAMETER})
@Retention(RetentionPolicy.RUNTIME)
@Constraint(validatedBy = CsvFileValidator.class)
public @interface ValidCsvFile {
    String message() default "文件格式无效，仅支持CSV格式";
    Class<?>[] groups() default {};
    Class<? extends Payload>[] payload() default {};
}

2. 实现校验器，复用现有格式判断逻辑：

public class CsvFileValidator implements ConstraintValidator<ValidCsvFile, MultipartFile> {
    private static final String[] TYPES = {"text/csv", "application/vnd.ms-excel"};

    @Override
    public boolean isValid(MultipartFile file, ConstraintValidatorContext context) {
        if (file == null || file.isEmpty()) {
            // 可根据业务需求处理空文件场景
            return false;
        }
        return Arrays.stream(TYPES).anyMatch(file.getContentType()::equals);
    }
}

3. 在Controller层启用校验：
   在Controller类上添加@Validated注解，然后在MultipartFile参数上标记@ValidCsvFile即可完成前置校验：

@RestController
@Validated
public class CsvUploadController {
    @PostMapping("/upload")
    public ResponseEntity<?> upload(@ValidCsvFile MultipartFile file) {
        csvService.create(file);
        return ResponseEntity.ok("上传成功");
    }
}

这种方式把校验逻辑前置到Controller层，避免了业务层的校验侵入，更符合MVC的职责划分。校验不通过时，Spring会抛出ConstraintViolationException，你可以在全局异常处理器中统一处理；如果需要更定制化的异常反馈，也可以在校验器中直接抛出自定义的NotValidFormatException。

问题2：单独创建自定义异常还是用通用异常处理方法？ #

建议单独创建NotValidFormatException类，理由如下：

• 语义明确：直接标识这是文件格式不合法的异常，和其他类型的异常（如资源不存在、普通参数错误）区分开，便于后续问题排查和维护。
• 扩展性强：后续如果需要给异常添加额外属性（比如用户上传的文件类型、允许的格式列表），单独的异常类更容易扩展调整。
• 响应精准：在全局异常处理器中可以针对该异常返回定制化的响应（比如特定错误码、更友好的提示信息），通用异常处理很难做到这种针对性。

示例全局异常处理器处理该异常的代码：

@ControllerAdvice
public class GlobalExceptionHandler {
    @ExceptionHandler(NotValidFormatException.class)
    public ResponseEntity<ErrorResponse> handleNotValidFormatException(NotValidFormatException ex) {
        ErrorResponse error = new ErrorResponse(HttpStatus.BAD_REQUEST.value(), ex.getMessage());
        return new ResponseEntity<>(error, HttpStatus.BAD_REQUEST);
    }

    // 其他异常处理方法...
}

如果项目中这类格式校验场景极少，且不需要区分异常类型，也可以复用通用参数校验异常的处理逻辑，但从长期维护的角度看，单独的异常类优势更明显。

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