请求参数中枚举类型的全局异常处理器实现咨询

1. GET接口控制器方法头部需添加的注解 #

• 方法上添加@GetMapping("/allTopic")，指定该方法处理路径为/allTopic的GET请求
• 入参filterCriteria前添加@ModelAttribute，让Spring自动将GET请求参数绑定到自定义对象的对应字段上（若控制器类标注了@RestController，无需额外加@ResponseBody，方法直接返回JSON响应）

示例代码片段：

@RestController
public class TopicController {
    @GetMapping("/allTopic")
    public List<Topic> getAllTopics(@ModelAttribute FilterCriteria filterCriteria) {
        // 业务逻辑实现
    }
}

2. filterCriteria类需添加的注解 #

• 在枚举类型Role的字段上添加@Enumerated(EnumType.STRING)，告知Spring将请求中的字符串参数转换为对应枚举实例，避免默认的数字序号转换引发错误
• 若需参数合法性校验（比如枚举值必须为指定可选值、字段必填），可在类上添加@Validated，并在字段上配合@NotNull等校验注解

示例代码片段：

import jakarta.persistence.Enumerated;
import jakarta.persistence.EnumType;
import jakarta.validation.constraints.NotNull;
import org.springframework.validation.annotation.Validated;

@Validated
public class FilterCriteria {
    @NotNull(message = "角色参数不能为空")
    @Enumerated(EnumType.STRING)
    private Role role;
    // 其他字段及getter/setter方法
}

public enum Role {
    student, teacher
}

3. @ControllerAdvice中@ExceptionHandler需处理的具体异常类型 #

需统一处理以下核心异常：

• MethodArgumentTypeMismatchException：当请求传入的字符串无法匹配枚举可选值时（比如传了admin这类无效值），Spring会抛出该异常
• ConstraintViolationException：若使用@Validated做参数校验，当字段不符合约束（比如role为空、枚举值无效）时会抛出该异常
• 额外可处理IllegalArgumentException：如果自定义了枚举转换逻辑，可能会手动抛出该异常，统一捕获可提升兼容性

示例代码片段：

import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.ResponseBody;
import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.web.method.annotation.MethodArgumentTypeMismatchException;
import jakarta.validation.ConstraintViolationException;

@ControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(MethodArgumentTypeMismatchException.class)
    @ResponseBody
    public ResponseEntity<String> handleTypeMismatch(MethodArgumentTypeMismatchException e) {
        String message = String.format("参数%s的值无效，允许的取值为：%s", 
            e.getName(), 
            String.join(", ", e.getRequiredType().getEnumConstants()));
        return new ResponseEntity<>(message, HttpStatus.BAD_REQUEST);
    }

    @ExceptionHandler(ConstraintViolationException.class)
    @ResponseBody
    public ResponseEntity<String> handleConstraintViolation(ConstraintViolationException e) {
        String message = e.getConstraintViolations().stream()
            .map(v -> v.getMessage())
            .findFirst()
            .orElse("参数校验失败");
        return new ResponseEntity<>(message, HttpStatus.BAD_REQUEST);
    }
}

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