ATG REST API：如何返回500以外的不同HTTP状态码

我来帮你分析下可能的问题点，以及对应的解决思路：

1. 检查自定义RestException的实现逻辑 #

你抛出的RestException如果只是单纯接收了响应对象和状态码，但没有在构造函数里实际修改响应的状态码，那服务器还是会默认返回500错误。

正确的异常类实现应该在构造阶段就完成响应状态码的设置，示例如下：

public class RestException extends RuntimeException {
    private final int statusCode;

    public RestException(String message, HttpServletResponse response, int statusCode) {
        super(message);
        this.statusCode = statusCode;
        
        // 确保响应未提交时修改状态码
        if (response != null && !response.isCommitted()) {
            response.setStatus(statusCode);
            // 可选：写入错误消息到响应体
            try {
                response.setContentType("application/json");
                response.getWriter().write("{\"error\":\"" + message + "\"}");
                response.getWriter().flush();
            } catch (IOException e) {
                // 处理IO异常，比如打日志
                e.printStackTrace();
            }
        }
    }

    // 提供获取状态码的方法，方便后续异常处理器使用
    public int getStatusCode() {
        return statusCode;
    }
}

2. 确认框架的异常处理机制是否捕获了RestException #

不同的REST框架（比如Spring MVC、JAX-RS）需要配置对应的异常处理器，否则自定义异常会被框架默认处理，返回500错误：

如果是Spring MVC #

使用@ControllerAdvice全局捕获异常，返回指定状态码：

@ControllerAdvice
public class GlobalRestExceptionHandler {
    @ExceptionHandler(RestException.class)
    public ResponseEntity<Map<String, String>> handleRestException(RestException ex) {
        Map<String, String> errorResponse = new HashMap<>();
        errorResponse.put("message", ex.getMessage());
        return new ResponseEntity<>(errorResponse, HttpStatus.valueOf(ex.getStatusCode()));
    }
}

如果是JAX-RS #

实现ExceptionMapper来映射异常到响应：

@Provider
public class RestExceptionMapper implements ExceptionMapper<RestException> {
    @Override
    public Response toResponse(RestException ex) {
        return Response.status(ex.getStatusCode())
                .entity(Map.of("error", ex.getMessage()))
                .type(MediaType.APPLICATION_JSON)
                .build();
    }
}

3. 排查响应是否已被提交 #

如果在抛出异常前，响应已经被提交（比如之前调用了response.flush()、写入了大量输出内容），此时再修改状态码会失效——因为响应头已经发送给客户端了。

可以在设置状态码前先判断：

if (response != null && !response.isCommitted()) {
    // 执行状态码设置逻辑
} else {
    // 响应已提交，只能记录日志或做其他补偿处理
    System.err.println("Response already committed, cannot set status code: " + statusCode);
}

4. 验证ServletUtil.getCurrentResponse()的有效性 #

确认这个工具类是否真的获取到了当前请求的HttpServletResponse对象。如果在某些非请求线程或特殊上下文里调用，可能返回null，导致状态码设置逻辑不执行。可以加调试日志或断点，检查该对象是否为null。

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