如何在JSP及index.jsp中设置HTTP Header？解决Filter未覆盖初始页面问题

我完全懂你的困扰——当用户直接访问index.jsp作为初始页面时，你的*.do过滤器根本没机会触发，导致没法给这个请求加上需要的HTTP Header。这里有几个实用的解决方案，你可以根据项目情况选择：

方案1：扩展现有Filter的映射范围，覆盖index.jsp #

这是最直接的办法，不用新增组件，只需要修改你现有Filter的URL映射规则，让它同时处理*.do和/index.jsp请求。

如果你用注解配置Filter： #

修改@WebFilter的urlPatterns属性，把/index.jsp也加进去：

@WebFilter(urlPatterns = {"*.do", "/index.jsp"})
public class HeaderSettingFilter implements Filter {

    @Override
    public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) 
            throws IOException, ServletException {
        HttpServletResponse httpResponse = (HttpServletResponse) response;
        // 这里是你原来设置Header的逻辑，比如：
        httpResponse.setHeader("X-Content-Type-Options", "nosniff");
        httpResponse.setHeader("Cache-Control", "no-cache, no-store, must-revalidate");
        
        chain.doFilter(request, response);
    }

    // init和destroy方法按需实现，不需要的话可以留空
    @Override
    public void init(FilterConfig filterConfig) throws ServletException {}

    @Override
    public void destroy() {}
}

如果你用web.xml配置Filter： #

在原有的<filter-mapping>里新增一个<url-pattern>标签：

<filter>
    <filter-name>HeaderSettingFilter</filter-name>
    <filter-class>com.yourpackage.HeaderSettingFilter</filter-class>
</filter>
<filter-mapping>
    <filter-name>HeaderSettingFilter</filter-name>
    <url-pattern>*.do</url-pattern>
    <url-pattern>/index.jsp</url-pattern>
</filter-mapping>

这个方案的好处是所有Header设置逻辑都集中在一个Filter里，便于维护。

方案2：直接在index.jsp中添加Header设置脚本 #

如果不想改动Filter的范围，也可以直接在index.jsp的最顶部添加一段JSP脚本，在页面输出前设置Header。

注意：这段脚本必须放在页面的最开头，确保没有任何输出（包括空格、换行）之前执行，否则会抛出IllegalStateException（因为HTTP Header在响应提交后就不能修改了）。

示例代码：

<%
    // 在这里设置你需要的HTTP Header
    response.setHeader("X-Frame-Options", "SAMEORIGIN");
    response.setHeader("Expires", "0");
%>
<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">
    <title>首页</title>
    <!-- 其他页面内容 -->
</head>
<body>
...
</body>
</html>

方案3：配置容器级别的全局Header（可选） #

如果你的项目部署在Tomcat这类容器上，还可以通过修改容器配置来给所有请求（包括静态资源和JSP）统一设置Header。比如在Tomcat的conf/web.xml或者项目的WEB-INF/web.xml里添加<filter>：

<filter>
    <filter-name>CommonHeaderFilter</filter-name>
    <filter-class>org.apache.catalina.filters.HttpHeaderSecurityFilter</filter-class>
    <init-param>
        <param-name>xFrameOptions</param-name>
        <param-value>SAMEORIGIN</param-value>
    </init-param>
    <!-- 可以添加更多Header参数 -->
</filter>
<filter-mapping>
    <filter-name>CommonHeaderFilter</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>

不过这个方案会影响所有请求，如果你只需要给index.jsp和*.do设置，前两个方案更精准。

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