REST服务如何返回不含堆栈跟踪的HTTP错误响应？

我来帮你搞定这个问题！你遇到的核心痛点是想在REST服务抛出异常时，返回仅包含错误码和动态错误信息的响应，同时避免暴露堆栈跟踪对吧？你的思路方向是对的，但之前的实现方式没完全踩对Spring异常处理的点，下面给你一步步修正：

首先，修复自定义异常类 #

你之前在GenericException上用@ResponseStatus的问题在于，这个注解的reason是静态硬编码的，没办法动态赋值。我们先把这个注解去掉，让异常只负责存储动态的状态码和错误信息：

public class GenericException extends Exception {
    private final HttpStatus httpCode;
    private final String errorMessage;

    public GenericException(HttpStatus httpCode, String errorMessage) {
        super(errorMessage); // 把错误信息传给父类，方便后续日志记录
        this.httpCode = httpCode;
        this.errorMessage = errorMessage;
    }

    // 必须提供getter，全局异常处理器需要读取这些值
    public HttpStatus getHttpCode() {
        return httpCode;
    }

    public String getErrorMessage() {
        return errorMessage;
    }
}

然后，配置全局异常处理器（核心解决方法） #

这才是实现动态错误响应的正确姿势——用@ControllerAdvice+@ExceptionHandler拦截所有控制器抛出的异常，自定义返回内容。之前你尝试这个没成功，大概率是没正确构造响应体或者没精准捕获自定义异常：

import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.bind.annotation.ExceptionHandler;

@ControllerAdvice
public class GlobalExceptionHandler {

    // 专门拦截我们自定义的GenericException
    @ExceptionHandler(GenericException.class)
    public ResponseEntity<ApiErrorResponse> handleGenericException(GenericException ex) {
        // 构造只包含必要信息的错误响应体
        ApiErrorResponse errorResponse = new ApiErrorResponse(
                ex.getHttpCode().value(),
                ex.getErrorMessage()
        );
        // 返回带指定HTTP状态码的响应
        return new ResponseEntity<>(errorResponse, ex.getHttpCode());
    }

    // 兜底处理所有未捕获的异常，避免返回堆栈信息给前端
    @ExceptionHandler(Exception.class)
    public ResponseEntity<ApiErrorResponse> handleAllUncaughtExceptions(Exception ex) {
        // 可以自定义默认错误信息，比如"服务器内部错误"
        ApiErrorResponse errorResponse = new ApiErrorResponse(
                HttpStatus.INTERNAL_SERVER_ERROR.value(),
                "服务器内部错误，请稍后重试"
        );
        return new ResponseEntity<>(errorResponse, HttpStatus.INTERNAL_SERVER_ERROR);
    }

    // 自定义错误响应DTO，和你的业务响应结构匹配
    public static class ApiErrorResponse {
        private int errorCode;
        private String errorMessage;

        public ApiErrorResponse(int errorCode, String errorMessage) {
            this.errorCode = errorCode;
            this.errorMessage = errorMessage;
        }

        // 必须提供getter，Spring才能把对象序列化为JSON返回
        public int getErrorCode() {
            return errorCode;
        }

        public String getErrorMessage() {
            return errorMessage;
        }
    }
}

最后，简化你的控制器代码 #

用@RestController替代@Controller+@ResponseBody，更符合REST服务的写法，同时保留原来的异常抛出逻辑（记得在catch块里把完整异常堆栈记录到日志，方便后端排查问题）：

import org.springframework.http.HttpStatus;
import org.springframework.web.bind.annotation.*;

@RestController
@RequestMapping("/message")
public class SendMessageController {
    private Logger log = LogManager.getLogger(getClass());
    
    @Autowired
    private QueueService queueService;

    // 用@PostMapping替代@RequestMapping，更简洁；用consumes指定接收JSON
    @PostMapping("/check")
    public ApiResponse sendMessage(@RequestBody String requestMessage) throws Exception {
        try {
            return new ApiResponse(queueService.processRequestForJSONString(requestMessage));
        } catch (Exception e) {
            // 把完整异常信息记录到日志，方便排查
            log.error("处理消息请求失败", e);
            // 抛出自定义异常，交给全局处理器处理响应
            throw new GenericException(HttpStatus.INTERNAL_SERVER_ERROR, e.getMessage());
        }
    }
}

为什么这个方案可行？ #

1. 全局拦截：@ControllerAdvice会作用于所有控制器，确保所有异常都能被统一处理
2. 动态响应：通过读取自定义异常里的动态状态码和错误信息，构造响应体，完全满足你的需求
3. 安全合规：前端只会收到错误码和自定义信息，不会暴露任何后端堆栈细节，同时后端日志里保留了完整异常信息方便排查

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