Spring+Vue项目中如何为静态文件设置Response setHeader？

针对你的场景，有两种常用方式可以给静态资源（包括你配置的 fallback 返回的index.html）设置响应头，以下是具体实现：

方式一：直接在资源处理器中配置（推荐） #

利用Spring 5.2+提供的setHeaders方法，可直接在addResourceHandlers配置中绑定响应头，仅对当前资源处理器管辖的静态资源生效：

@Override
public void addResourceHandlers(ResourceHandlerRegistry registry) {
    registry.addResourceHandler("/**/*")
            .addResourceLocations("classpath:/static/")
            // 添加响应头配置
            .setHeaders(headers -> {
                // 示例：设置缓存控制头
                headers.setCacheControl(CacheControl.maxAge(365, TimeUnit.DAYS).cachePublic());
                // 自定义响应头
                headers.add("X-Custom-Header", "Vue-Static-Resource");
            })
            .resourceChain(true)
            .addResolver(new PathResourceResolver() {
                @Override
                protected Resource getResource(String resourcePath, Resource location) throws IOException {
                    Resource requestedResource = location.createRelative(resourcePath);
                    return requestedResource.exists() && requestedResource.isReadable() ? requestedResource : new ClassPathResource("/static/index.html");
                }
            });
}

这种方式优势是精准绑定静态资源范围，不会影响其他接口的响应头，配置简洁直观。

方式二：使用拦截器全局处理 #

如果你的Spring版本较低，或者需要更灵活的判断逻辑，可通过自定义拦截器为静态资源添加响应头：

1. 编写拦截器类 #

@Component
public class StaticResourceHeaderInterceptor implements HandlerInterceptor {
    @Override
    public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {
        // 判断当前请求是否由静态资源处理器处理
        if (handler instanceof ResourceHttpRequestHandler) {
            // 设置缓存控制头
            response.setHeader("Cache-Control", "public, max-age=31536000");
            // 自定义响应头
            response.setHeader("X-Custom-Header", "Vue-Static-Resource");
        }
    }
}

2. 注册拦截器 #

在WebMvc配置类中添加拦截器：

@Override
public void addInterceptors(InterceptorRegistry registry) {
    registry.addInterceptor(new StaticResourceHeaderInterceptor());
}

这种方式适合对所有静态资源统一设置头的场景，需通过handler instanceof ResourceHttpRequestHandler区分静态资源请求，避免给接口请求误加头。

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