Spring Boot关闭Closeable时返回200，异常无法返回错误码如何解决

• 只要你调用HttpServletResponse.getWriter()获取输出流后，输出流一旦被flush()或者close()，Servlet容器就会提交响应：默认设置状态码为200，响应头和状态码一旦提交就无法修改，后续抛出的异常也不会被Spring MVC处理生成错误响应。
• 你用的CSVPrinter的close()方法默认会自动flush底层绑定的PrintWriter，所以不管是手动关还是try-with-resources自动关，只要异常触发关闭逻辑，就会先提交200状态码，再抛异常就没用了。

方案1：关闭CSVPrinter前手动设置错误状态码 #

不需要依赖Spring的异常处理器处理状态，在捕获异常时先给response设状态码，再关闭CSVPrinter即可：

try {
    csvPrinter = new CSVPrinter(httpServletResponse.getWriter() , CSVFormat.DEFAULT);
    System.out.println(1/0); // 模拟异常
} catch (Exception e) {
    e.printStackTrace();
    // 先设置错误状态码，再关闭流
    httpServletResponse.setStatus(HttpServletResponse.SC_INTERNAL_SERVER_ERROR);
    try { 
        // 可以按需写入错误提示文本
        httpServletResponse.getWriter().write("导出失败：" + e.getMessage());
        csvPrinter.close(true); 
    } catch (IOException e1) { 
        e1.printStackTrace(); 
    }
    // 状态码已经设置完成，无需再抛异常
    return;
}

方案2：调整CSVPrinter配置，关闭自动flush #

初始化CSVPrinter的时候指定withAutoFlush(false)，这样close的时候不会自动flush底层流，异常抛出后Spring可以正常处理响应状态：

try( final CSVPrinter csvPrinter = new CSVPrinter( 
        httpServletResponse.getWriter() , 
        CSVFormat.DEFAULT.withAutoFlush(false) // 关闭自动flush
) ){
    System.out.println(1/0); // 模拟异常
    // 正常业务结束后手动flush，避免内容丢失
    csvPrinter.flush();
} catch (Exception e) {
    throw new RuntimeException("导出错误", e);
}

注意：正常流程结束后必须手动调用csvPrinter.flush()，否则导出的内容会不全。

方案3：增加全局异常处理器兼容现有写法 #

如果不想修改业务代码，可以新增Spring全局异常处理器，在响应未提交的场景下会自动设置错误状态码：

@RestControllerAdvice
public class GlobalExceptionHandler {
    @ExceptionHandler(RuntimeException.class)
    public void handleRuntimeException(RuntimeException e, HttpServletResponse response) throws IOException {
        // 仅当响应未提交时设置状态码
        if (!response.isCommitted()) {
            response.setStatus(HttpServletResponse.SC_INTERNAL_SERVER_ERROR);
            response.getWriter().write(e.getMessage());
        }
    }
}

如果响应已经被提交，这个处理器不会生效，所以优先使用方案1或2更稳妥。

• 必须主动关闭：CSVPrinter属于IO资源，不主动关闭会导致内存泄漏、文件句柄泄漏等问题，高并发场景下风险极高。
• try-with-resources是最推荐的写法，不需要手动处理关闭逻辑，只要资源实现了AutoCloseable接口就可以使用。

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