Spring Boot REST接口未实现时如何抛出自定义异常？

嗨，针对你在Spring Boot REST应用中遇到的「命中未实现的GET/PUT等HTTP方法时抛出自定义异常」的问题，我给你整理了两种实用的解决方案，适配不同的场景需求：

方案1：全局捕获Spring默认异常并转换为自定义异常 #

Spring在接收到不支持的HTTP方法请求时，会自动抛出HttpRequestMethodNotSupportedException。我们可以通过全局异常处理器捕获这个异常，然后转换成自定义异常返回（或直接构造友好的错误响应）。

步骤1：定义自定义异常类 #

// 自定义业务异常，用于标记未实现的HTTP方法
public class UnsupportedMethodException extends RuntimeException {
    public UnsupportedMethodException(String message) {
        super(message);
    }
}

步骤2：创建全局异常处理器 #

用@RestControllerAdvice实现全局异常捕获，统一处理所有请求的异常：

@RestControllerAdvice
public class GlobalExceptionHandler {

    // 捕获Spring默认的不支持HTTP方法异常
    @ExceptionHandler(HttpRequestMethodNotSupportedException.class)
    public ResponseEntity<ErrorResponse> handleHttpRequestMethodNotSupported(HttpRequestMethodNotSupportedException ex) {
        String errorMsg = String.format("请求方法【%s】尚未实现，请检查接口定义", ex.getMethod());
        // 这里可以选择直接抛出自定义异常，或者构造响应返回
        // throw new UnsupportedMethodException(errorMsg);
        
        // 构造标准化错误响应
        ErrorResponse errorResponse = new ErrorResponse(
            HttpStatus.METHOD_NOT_ALLOWED.value(),
            errorMsg
        );
        return new ResponseEntity<>(errorResponse, HttpStatus.METHOD_NOT_ALLOWED);
    }

    // 处理自定义的未实现方法异常（如果选择抛出的话）
    @ExceptionHandler(UnsupportedMethodException.class)
    public ResponseEntity<ErrorResponse> handleUnsupportedMethodException(UnsupportedMethodException ex) {
        ErrorResponse errorResponse = new ErrorResponse(
            HttpStatus.METHOD_NOT_ALLOWED.value(),
            ex.getMessage()
        );
        return new ResponseEntity<>(errorResponse, HttpStatus.METHOD_NOT_ALLOWED);
    }

    // 自定义错误响应体，用于统一返回格式
    static class ErrorResponse {
        private int status;
        private String message;

        public ErrorResponse(int status, String message) {
            this.status = status;
            this.message = message;
        }

        // 省略getter/setter，推荐用Lombok的@Data简化代码
        public int getStatus() { return status; }
        public void setStatus(int status) { this.status = status; }
        public String getMessage() { return message; }
        public void setMessage(String message) { this.message = message; }
    }
}

方案2：自定义路由映射器，在匹配阶段主动抛出自定义异常 #

如果需要更细粒度的控制（比如在路由匹配阶段就拦截并抛出异常，而不是等Spring抛出默认异常），可以自定义RequestMappingHandlerMapping：

@Component
public class CustomRequestMappingHandlerMapping extends RequestMappingHandlerMapping {

    @Override
    protected HandlerMethod lookupHandlerMethod(String lookupPath, HttpServletRequest request) throws Exception {
        try {
            // 先执行Spring默认的路由匹配逻辑
            return super.lookupHandlerMethod(lookupPath, request);
        } catch (HttpRequestMethodNotSupportedException ex) {
            // 捕获到不支持的方法时，主动抛出自定义异常
            throw new UnsupportedMethodException(
                String.format("路径【%s】不支持【%s】方法，该功能尚未实现", lookupPath, request.getMethod())
            );
        }
    }
}

注意：这个方案需要配合方案1中对UnsupportedMethodException的全局处理，才能返回标准化的错误响应。

额外提示 #

• 全局异常处理器是最推荐的方式，避免在每个Controller中重复编写异常处理代码，符合DRY原则。
• 如果你的IProcess接口需要和HTTP方法绑定，可以考虑在Controller层通过@GetMapping/@PutMapping等注解明确映射，未映射的方法会自动触发上述异常处理逻辑。

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