在 apache 的 <directory></directory> 配置中,通过加载 mod_headers 模块并使用 header unset etag 指令来清除默认的 etag 头,从而控制缓存校验。默认情况下,apache 会根据文件的 inode、大小和修改时间生成 etag,这在跨服务器或 nfs 环境下可能导致缓存不一致。执行该操作后,响应中将不再包含 etag 字段,客户端将仅依赖 last-modified 进行验证。

如何禁用默认的 ETag 生成以避免跨服务器缓存错误
要彻底禁用 Apache 自动生成的 ETag,需要在 <directory></directory> 块中设置 FileETag none 并取消响应头中的 ETag。这能防止因文件元数据(如 inode)不同但内容相同而导致的缓存失效问题。

# /etc/apache2/apache2.conf 或虚拟主机配置
<Directory /var/www/html>
# 1. 告诉 Apache 不要生成任何类型的 ETag
FileETag none
# 2. 确保响应头中不包含 ETag 字段
Header unset ETag
# 可选:启用 Last-Modified 作为替代校验方式
FileETag MTime Size
</Directory>
上述配置中,FileETag none 阻止了服务器端计算 ETag,而 Header unset ETag 是双重保险,确保即使有内部逻辑生成了该头也会被移除。重启 Apache 服务后,使用 curl -I http://localhost/ 检查响应头,确认 ETag 字段消失。
如何自定义 ETag 以支持特定内容的缓存策略
如果不需要完全禁用,而是希望基于特定属性(如仅修改时间)生成 ETag,可以使用 FileETag 指令指定参数。常见的参数包括 MTime(修改时间)、Size(文件大小)和 INode(inode 号)。在 <directory></directory> 中组合这些参数可以精细控制缓存行为。
通过Apache Tika Server REST API从1400多种文件格式中提取文本和元数据。处理PDF、DOCX、PPTX、电子邮件归档以及带有MIME类型检测的嵌入式文档提取。

<Directory /var/www/html/static>
# 仅基于修改时间和大小生成 ETag,忽略 inode
# 适用于多服务器共享存储场景
FileETag MTime Size
# 确保 ETag 被发送
Header set ETag "\"custom-etag\""
</Directory>
在此配置中,FileETag MTime Size 使得 ETag 值由文件的最后修改时间和字节大小哈希而成。当文件内容改变时,这两个值通常会变化,从而触发缓存更新。若需完全自定义 ETag 值,可结合 RewriteRule 或 Header set 动态生成,但通常 FileETag 的参数组合已能满足大多数缓存优化需求。
配置 FileETag 后如何验证缓存校验是否生效
配置完成后,通过 HTTP 请求验证 ETag 头的存在与否及 If-None-Match 的处理逻辑。使用 curl 工具模拟客户端请求,观察状态码和响应头变化,确认缓存控制策略按预期工作。
# 第一次请求,获取完整资源 $ curl -I http://localhost/test.html HTTP/1.1 200 OK ETag: "12345-67890" Last-Modified: Wed, 21 Oct 2023 07:28:00 GMT # 第二次请求,携带 If-None-Match 头 $ curl -I -H "If-None-Match: \"12345-67890\"" http://localhost/test.html HTTP/1.1 304 Not Modified # 若已禁用 ETag,则不会返回 304,而是 200 或依赖 Last-Modified $ curl -I -H "If-None-Match: \"any-value\"" http://localhost/test.html HTTP/1.1 200 OK Last-Modified: Wed, 21 Oct 2023 07:28:00 GMT
验证过程中,重点检查状态码是否为 304 Not Modified,以及响应头中是否包含预期的 ETag 或 Last-Modified。若配置为 FileETag none,则 If-None-Match 请求应返回 200 OK,因为服务器无法匹配不存在的 ETag。此步骤确保缓存策略在实际网络环境中正确运行。

















