ThinkPHP 不自动设置 ETag，需手动计算并写入响应头；ETag 是资源唯一标识，用于协商缓存；正确做法是在 return 前用业务数据生成稳定哈希值并设 header。
ThinkPHP 的 Response 对象本身不直接提供 setETag() 方法，ETag 生成和设置必须手动控制——框架只在特定中间件（如 CheckRequestCache）中按需计算并写入响应头，但该逻辑默认不启用，且对 JSON 接口基本无效。
ETag 是什么，为什么不能依赖自动设置
ETag 是服务端为资源生成的唯一标识符（如文件内容哈希、数据版本号），用于协商缓存。ThinkPHP 默认不自动生成 ETag，CheckRequestCache 中途件虽含 ETag 生成逻辑，但它：
- 仅在开启请求缓存时触发，而 JSON 接口通常禁用该中间件
- 依赖 Response::getContent() 输出内容，若控制器中提前调用 exit 或 die，内容为空导致 ETag 计算错误
- 不兼容协程常驻模式下多次请求间的内容变化检测
手动设置 ETag 的正确姿势
最可靠的方式是：在控制器中显式计算并写入响应头，确保时机可控、内容可信。关键点如下：
- 必须在
return响应前设置，且不能晚于Response::send()调用 - ETag 值建议用
md5(serialize($data))或sha1($json_string)，避免用时间戳或随机数 - 要配合
Cache-Control: no-cache或must-revalidate，否则浏览器可能跳过协商 - 若使用
json()响应，需先获取原始数据再计算，不能对已编码的 JSON 再哈希（会因空格/换行不稳定）
示例（控制器方法中）：
$data = ['user_id' => 1001, 'name' => 'Tom'];
$etag = md5(serialize($data));
return json($data)->header('ETag', '"' . $etag . '"')->header('Cache-Control', 'no-cache');和 Nginx ETag 的协作关系
如果 Nginx 已配置 etag on;，它会在静态文件响应中自动加 ETag；但 PHP 动态响应不受影响——Nginx 不会覆盖你手动设置的 ETag 头，也不会帮你生成。所以：
立即学习“PHP免费学习笔记（深入）”；
- 动态接口务必自己设
ETag，别指望 Nginx 代劳 - 若同时开启 Nginx FastCGI 缓存，需确保
fastcgi_cache_valid包含200 1h等指令，并在 PHP 响应中带Cache-Control，否则 Nginx 可能不缓存 - 不要在 Nginx 和 PHP 两端重复设 ETag，后者优先，前者会被忽略
真正难的是 ETag 值的稳定性：同一资源在不同服务器、不同 PHP 版本、不同序列化顺序下，serialize() 结果可能不一致。生产环境建议改用业务字段拼接（如 "v1-{$user_id}-{$updated_at}"）再哈希，而非依赖 PHP 序列化。
