Tomcat 9中ExpiresFilter对根资源（首页）不生效问题排查

针对你遇到的Tomcat 9中ExpiresFilter对根路径/（首页）不生效的问题，结合日志显示已设置过期时间但实际响应头缺失的现象，可能的原因及解决方式如下：

1. 首页后端代码覆盖了响应头 #

如果首页由Servlet、JSP或其他后端组件生成，代码中可能存在修改缓存响应头的逻辑：

• 检查首页对应的Servlet/JSP代码，是否调用了response.setHeader("Expires", ...)、response.setHeader("Cache-Control", ...)直接覆盖Filter设置的头；
• 排查是否有response.reset()或response.resetBuffer()这类清空响应头的操作，会直接清除Filter已设置的Expires头。

2. 其他Filter或Valve后续修改了响应头 #

如果web.xml中存在其他Filter，且执行顺序在ExpiresFilter之后，可能会修改甚至删除缓存相关响应头：

• 调整filter-mapping的顺序，将CachingFilter的映射放在所有Filter的最后，确保它设置的响应头不会被后续Filter覆盖；
• 检查Tomcat的全局Valve配置（如server.xml中的Host/Context节点），是否存在缓存相关的Valve（如CachingValve），这类组件可能会在Filter之后修改响应头。

3. Tomcat Context的默认缓存配置干扰 #

Tomcat的Context配置可能存在默认的缓存控制参数，优先级覆盖了Filter的设置：

• 检查context.xml（全局或项目本地）中的Context节点，是否配置了cacheMaxAge、cacheDisable等参数，这类参数会直接控制静态资源或首页的缓存行为；
• 若存在cacheDisable="true"这类配置，会直接禁用缓存，需要调整或移除该配置。

4. 客户端/代理缓存的误判 #

浏览器或中间代理可能缓存了旧的响应，导致你看到的是无Expires头的缓存内容：

• 使用命令行工具直接请求服务器，绕过客户端缓存验证，比如执行：

  curl -I http://your-server-domain/
  

  查看返回的响应头，确认服务器实际返回的内容是否包含Expires头。

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