在HandlerInterceptorAdapter中添加响应头失败，除OncePerRequestFilter外还有其他方案吗？

嘿，我之前也踩过类似的坑！你在postHandle里加响应头没效果，大概率是因为**响应已经被提交（committed）**了——比如你用了@ResponseBody、ResponseEntity这类返回方式，Spring会在postHandle执行之前就把响应体写入并提交给客户端，这时候再修改响应头自然就失效了。

下面给你几种可行的解决方案，除了你提到的OncePerRequestFilter，还有适配不同场景的其他方法：

1. 用OncePerRequestFilter（全局通用方案） #

这是最稳妥的全局解决方案，因为Filter的执行时机早于Interceptor，能确保在响应提交前修改头信息。示例代码如下：

@Component
public class HeaderFilter extends OncePerRequestFilter {
    @Override
    protected void doFilterInternal(HttpServletRequest request, 
                                    HttpServletResponse response, 
                                    FilterChain filterChain) throws ServletException, IOException {
        // 可以在请求处理前添加头，也可以在filterChain.doFilter之后（确保业务逻辑执行完再操作）
        response.addHeader("header_name", "your_value");
        filterChain.doFilter(request, response);
    }
}

这个方法适用于所有类型的请求，不管是页面渲染还是REST接口。

2. 用@ControllerAdvice + ResponseBodyAdvice（适配REST接口） #

如果你的接口都是返回JSON/XML这类响应体的REST接口，用ResponseBodyAdvice是更贴合Spring MVC架构的方式，它能在响应体写入之前拦截并修改响应头：

@ControllerAdvice
public class ResponseHeaderAdvice implements ResponseBodyAdvice<Object> {

    @Override
    public boolean supports(MethodParameter returnType, Class<? extends HttpMessageConverter<?>> converterType) {
        // 这里可以指定哪些接口需要处理，返回true表示启用当前Advice
        return true;
    }

    @Override
    public Object beforeBodyWrite(Object body, MethodParameter returnType, 
                                  MediaType selectedContentType, 
                                  Class<? extends HttpMessageConverter<?>> selectedConverterType,
                                  ServerHttpRequest request, ServerHttpResponse response) {
        // 在这里添加响应头
        response.getHeaders().add("header_name", "your_value");
        return body;
    }
}

这种方法只对带有@ResponseBody或者返回ResponseEntity的控制器方法生效，不会影响页面渲染的请求。

3. 检查响应状态后在Interceptor中处理（仅适用于未提交响应的场景） #

如果你的请求是传统的视图渲染（比如返回JSP/Thymeleaf页面），postHandle理论上是可以修改响应头的。但如果是异步请求或者某些特殊场景导致响应提前提交，可以先判断响应状态再操作：

@Override
public void postHandle(HttpServletRequest request, 
                       HttpServletResponse response, 
                       Object handler, 
                       ModelAndView modelAndView) {
    if (!response.isCommitted()) {
        response.addHeader("header_name", "your_value");
    }
}

不过这种方法局限性大，只适合能确保响应未被提交的场景，可靠性不如前两种方案。

总结一下：如果是全局所有请求都要加头，优先用OncePerRequestFilter；如果只是REST接口需要处理，用ResponseBodyAdvice更合适；传统视图场景可以尝试在postHandle里加判断，但还是推荐前两种方案。

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