Apache TrafficServer 缓存刷新时 Content-Type 头部丢失问题分析

Apache TrafficServer 是一款高性能的 HTTP 缓存中转服务器，在 9.2.5 版本中存在一个与缓存刷新相关的头部处理问题。当服务器处理带有重复头部的 304 Not Modified 响应时，会导致 Content-Type 头部丢失，进而可能影响客户端对响应内容的正确处理。

问题现象

在缓存刷新场景下（TCP_REFRESH_HIT/200），当后端服务器返回 304 Not Modified 响应且包含重复头部时，TrafficServer 在转发响应时会丢失 Content-Type 头部。具体表现为：

1. 首次请求（TCP_MISS/200）时，所有头部包括 Content-Type 都能正确传递
2. 缓存过期后刷新请求（TCP_REFRESH_HIT/200）时：
   • 如果后端返回 200 OK，头部传递正常
   • 如果后端返回 304 Not Modified 且包含重复头部，则 Content-Type 头部丢失

问题根源

通过分析调试日志和代码，发现问题出在 TrafficServer 处理 304 响应时的头部合并逻辑中。当响应中包含重复头部时，服务器在合并新旧头部时未能正确处理 Content-Type 这一关键头部字段。

特别值得注意的是，这个问题与重复头部的处理方式有关：

• 当重复头部值相同时问题会出现
• 当重复头部值不同时（会被合并为逗号分隔列表），问题同样会出现

影响范围

该问题主要影响以下场景：

1. 使用 TrafficServer 9.2.5 版本
2. 后端服务器在 304 响应中返回重复头部
3. 响应内容依赖正确的 Content-Type 进行解析（如 application/javascript 等）

解决方案

Apache 社区已经针对此问题提交了修复补丁。建议用户：

1. 升级到已修复该问题的 TrafficServer 版本
2. 如果暂时无法升级，可以通过以下方式缓解：
   • 确保后端服务器不在 304 响应中发送重复头部
   • 使用插件强制添加 Content-Type 头部

最佳实践

为避免类似问题，建议：

1. 保持 TrafficServer 版本更新
2. 规范后端服务器的头部返回，避免重复头部
3. 对关键头部（如 Content-Type）进行监控
4. 在生产环境升级前，充分测试缓存刷新场景

这个问题提醒我们，在构建缓存中转架构时，不仅需要关注缓存命中率等性能指标，还需要特别注意头部处理的正确性，以确保内容的正确解析和呈现。