详解 Nginx 处理后端服务器返回 304 Not Modified 时的头部合规性审计

夏枫同学_8332

夏枫同学_8332

2026-05-11

923人浏览

原创

Nginx 不转发后端返回的 304,因其要求上游响应含完整 body,而 304 规范禁止携带 body,故默认拒收并报 502;正确做法是后端返回带 Last-Modified/ETag 的 200,由 Nginx 自主生成 304。

详解 nginx 处理后端服务器返回 304 not modified 时的头部合规性审计

nginx 本身不生成 304 响应,也不会“处理”后端返回的 304 —— 它根本不会把 304 转发给客户端。这是关键前提。

nginx 对后端 304 的实际行为

当 nginx 作为反向代理(例如用 proxy_pass)时,如果上游服务器(如 Node.js、Django、Tomcat)直接返回了 304 状态码,nginx 默认会拒绝转发该响应,并返回 502 Bad Gateway 或静默丢弃,因为:

  • nginx 的代理模块(ngx_http_proxy_module)要求上游必须返回完整响应体(含 body)才能被正常透传;而 304 规范明确禁止携带响应体;
  • nginx 在收到无 body 的 304 后,无法构造合法的 proxy 缓存键或填充必要头部,会判定为协议违规;
  • 日志中通常出现 "upstream sent no valid HTTP/1.0 header" 或 "upstream prematurely closed connection" 类错误。

为什么后端不该直接返回 304 给 nginx

304 是专为终端浏览器设计的协商缓存响应,其语义依赖于客户端已持有完整资源副本 + 有效条件请求头(If-Modified-Since / If-None-Match)。但 nginx 作为中间层:

Nginx Hosting
Nginx Hosting

通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式,无需登录、无需令牌、无需用户操作。

下载
  • 不保存原始资源内容,无法验证“未修改”是否成立;
  • 若上游擅自返回 304,等于绕过 nginx 的缓存控制逻辑(如 proxy_cache、expires),导致缓存策略失效;
  • 违反 HTTP 分层职责:协商缓存应由最靠近用户的组件(浏览器或 nginx 自身)完成,而非交由后端决策。

合规的替代方案:让 nginx 主导 304 决策

正确做法是:后端始终返回 200 + 完整内容 + 合规的校验头(Last-Modified 和/或 ETag),由 nginx 根据这些头自主判断并生成 304。配置要点包括:

  • 启用 proxy_cache 并设置 proxy_cache_valid 200 302 1h;;
  • 确保后端响应含 Last-Modified(基于文件 mtime)或强 ETag(如 SHA256 内容哈希);
  • 在 location 块中添加:
    proxy_ignore_headers Last-Modified ETag;
    proxy_cache_use_stale off;
    add_header X-Cache-Status $upstream_cache_status;
  • nginx 收到带 If-Modified-Since 的请求后,会比对缓存中的 Last-Modified 值,匹配则自动生成 304,不触达后端。

头部合规性审计要点

若仍需调试上游误发 304 的场景,可抓包检查其响应是否满足 RFC 7232 要求:

  • 必须不含 Content-Length、Content-Encoding、Transfer-Encoding 等 body 相关头;
  • 可包含:Cache-Control、Expires、Vary、ETag(仅当与 If-None-Match 匹配时)、Last-Modified(仅当与 If-Modified-Since 匹配时);
  • 禁止出现 Location、Content-Type、Set-Cookie 等 200 常用头;
  • 响应体必须为空(0 字节),且不能有额外换行或空格。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

nginx

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

2783

5

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

2024.03.19

6990

13

后端的主要工作内容介绍
后端的主要工作内容介绍

后端是应用程序的服务端部分,负责核心任务,如数据库交互、业务逻辑处理和响应客户端请求。想了解更多后端的相关内容,可以阅读本专题下面的文章。

2024.03.19

6486

10

服务器是什么
服务器是什么

服务器是一种计算机硬件设备或软件程序,它具有强大的计算和存储能力,用请求、存储数据和提供服务。它在互联网中着关重要的作用,为用户提供各种服务和资源。本专题为大家提供服务器相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.15

457

5

连接apple id服务器时出错
连接apple id服务器时出错

连接apple id服务器时出错的原因包括网络连接问题、服务器问题、Apple ID账户问题、设备问题、防火墙或安全软件问题、时间和日期设置问题、Apple服务器维护等。本专题为大家提供apple id相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.08

960

5

搭建互联网服务器
搭建互联网服务器

搭建互联网服务器需要:1、选择合适的硬件和操作系统,第一步是选择合适的硬件和操作系统;2、安装和配置操作系统,是搭建互联网服务器的关键步骤;3、安装和配置服务器软件,是搭建互联网服务器的下一步,常见的服务器软件包括Apache、Nginx、Tomcat等;4、配置防火墙和安全性,是搭建互联网服务器的重要步骤;5、域名解析和配置,是搭建互联网服务器的最后一步。

2023.09.19

3332

5

如何查看服务器状态
如何查看服务器状态

查看服务器状态的方法有使用命令行工具、图形界面工具、监控工具、日志文件和远程管理工具等。本专题为大家提供服务器状态相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.09

1096

5

服务器域名转接慢怎么解决
服务器域名转接慢怎么解决

服务器域名转接慢的解决办法有DNS优化、服务器优化、CDN加速、前端优化和网络优化等。本专题为大家提供服务器相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.17

969

5

服务器评测软件
服务器评测软件

服务器评测软件有PassMark Software、CPU-Z、GPU-Z、CrystalDiskMark、IOmeter、JMeter、LoadRunner、Apache Bench等等。详细介绍:1、PassMark Software是一款综合性的服务器性能测试软件,可以评估服务器在各种负载条件下的性能;2、CPU-Z是一款可以提供服务器CPU详细信息的软件等等。

2023.10.17

514

3

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
phpEnv手册
phpEnv手册

共0课时 | 0人学习

nginx手册
nginx手册

共0课时 | 0人学习

进程与SOCKET
进程与SOCKET

共6课时 | 0.5万人学习