Nginx 默认支持 If-Modified-Since 协议机制,通过自动添加 Last-Modified 响应头(基于文件 mtime)并在文件未修改时返回 304,配合 expires 实现高效缓存;需确保不覆盖 Last-Modified、权限正常且合理设置缓存策略。

HTTP If-Modified-Since 是一个客户端请求头,用于向服务器询问“该资源自某个时间后是否被修改过”。Nginx 本身不直接处理这个头来生成响应(比如自动比对文件修改时间并返回 304),但可以配合 expires、add_header 和内置变量(如 $sent_http_last_modified)实现合理缓存控制。真正起作用的是浏览器和 Nginx 共同遵守的 HTTP 协议规范,而非 Nginx 主动“利用 if_modified_since”做判断。
理解 If-Modified-Since 的工作流程
当浏览器已缓存某资源,并且该资源响应中包含 Last-Modified 头时,下次请求会自动带上 If-Modified-Since,值为上次收到的 Last-Modified 时间。Nginx 若发现请求文件未在此时间之后修改过,就返回 304 Not Modified,不传输响应体,节省带宽和时间。
Nginx 默认对静态文件(如 .js、.css、图片)在启用 expires 指令时,会自动添加 Last-Modified 响应头(基于文件 mtime)。只要没禁用或覆盖该行为,整个机制就能自然生效。
确保 Last-Modified 正确发送
这是触发 If-Modified-Since 的前提。检查你的 server 或 location 块中是否无意清除了该头:
- 避免使用
add_header Last-Modified ""或unset $sent_http_last_modified类操作 - 静态资源 location 中建议显式开启
etag off;(可选,避免 ETag 与 If-None-Match 干扰逻辑) - 确认文件系统权限正常,Nginx 能读取文件元数据(否则无法获取 mtime,Last-Modified 可能为空或出错)
配合 expires 提升缓存效率
仅靠 304 不够高效——每次都要发一次请求验证。应优先用强缓存(Cache-Control: max-age 或 Expires)延长本地缓存周期,让 If-Modified-Since 只在过期后才触发:
-
推荐做法:对不变资源(如带哈希的 JS/CSS)设长缓存:
expires 1y;,并确保 URL 随内容变化 - 对可能更新的资源(如首页 HTML),设短缓存+Last-Modified:
expires 10m;,依赖 If-Modified-Since 减少重复传输 - 不要对动态接口(PHP/Proxy)盲目加 expires,除非你明确控制了内容新鲜度
验证是否生效
用浏览器开发者工具 > Network 标签页查看请求/响应头:
- 首次请求:检查响应是否有
Last-Modified(如Wed, 01 Jan 2025 00:00:00 GMT) - 刷新页面(或稍等缓存过期后):检查后续请求头是否含
If-Modified-Since,且值与上一次的Last-Modified一致 - 若文件未改动,响应状态码应为
304 Not Modified,响应体为空,Content-Length: 0

















