Python 304状态码本质是“未修改”，它告诉浏览器服务器上的资源自上次请求以来没有发生变化，浏览器可直接使用本地缓存，无需重新下载完整内容。
在Web开发的高并发场景下，每一次HTTP请求都伴随着网络延迟和服务器计算资源的消耗，当用户频繁刷新页面或客户端轮询接口时，如果服务器每次都返回完整的200 OK响应并附带全部数据，不仅浪费带宽，还会显著拖慢应用响应速度，Python 304正是解决这一痛点的关键机制，它不是错误，而是一种高效的缓存验证信号，通过合理利用这一状态码，开发者可以在保证数据一致性的前提下,极大提升应用性能并降低服务器负载。
Python 304状态码的核心机制与工作原理
理解Python 304，首先要明白HTTP协议是无状态的，但浏览器需要一种机制来“之前获取的资源，304 Not Modified 是HTTP/1.1协议中定义的状态码,它依赖于客户端与服务端之间的协商机制。
ETag与Last-Modified的协同作用
服务器通常使用两种头部字段来标识资源是否变更：
ETag（实体标签）
ETag是一个由服务器生成的唯一标识符，通常基于文件的哈希值或版本号，当客户端再次请求同一资源时，会将之前收到的ETag值放在请求头的If-None-Match字段中，服务器对比当前资源的ETag，如果一致，则返回304。
Last-Modified（最后修改时间）
这是一个较老的标准，记录资源最后一次被修改的时间戳，客户端在后续请求中通过If-Modified-Since头部发送该时间，如果服务器发现资源在此时间后未被修改，便返回304。
业内专家指出，ETag相比Last-Modified更为精确，因为Last-Modified只能精确到秒，且受服务器时钟同步问题影响，而ETag可以基于文件内容生成,能捕捉到秒级以内的微小变动。
在Python Web框架中实现304响应的实操指南
在Python生态中，无论是轻量级的Flask、Django还是高性能的FastAPI，实现304响应都非常直观，核心逻辑在于：检查客户端请求头中的验证信息，并与服务器端资源状态比对,若未变化则返回304。
Flask框架下的具体实现路径
Flask提供了便捷的装饰器和响应对象来处理缓存,以下是实现304响应的标准步骤：
- 获取资源内容：首先读取文件或生成数据。
- 生成ETag：使用
werkzeug.http.generate_etag或类似方法生成唯一标识。 - 比对请求头：检查
request.if_none_match是否包含生成的ETag。 - 返回响应：如果匹配，返回304；否则返回200并设置ETag头。
from flask import Flask, request, make_response
import hashlib
app = Flask(__name__)
@app.route('/api/data')
def get_data():
# 模拟获取数据
data_content = "some dynamic content"
etag = hashlib.md5(data_content.encode()).hexdigest()
# 检查客户端是否携带了相同的ETag
if request.if_none_match and etag in request.if_none_match:
# 资源未修改，返回304
response = make_response('', 304)
return response
# 资源已修改或首次请求，返回200
response = make_response(data_content)
response.headers['ETag'] = etag
response.headers['Cache-Control'] = 'public, max-age=3600'
return response
Django中的中间件与装饰器方案
Django内置了ConditionalGetMiddleware，可以自动处理304响应，只需在MIDDLEWARE配置中启用该中间件，Django会自动检查If-Modified-Since和If-None-Match头部。
对于更细粒度的控制，可以使用@condition装饰器：
from django.views.decorators.http import condition from django.http import HttpResponse def get_etag(request, pk): # 根据业务逻辑生成etag return 'etag-value-for-resource-' + pk def last_modified(request, pk): # 返回最后修改时间 return None @condition(etag_func=get_etag, last_modified_func=last_modified) def my_view(request, pk): return HttpResponse("Resource Content")
这种自动化处理减少了重复代码,适合大多数标准Web应用。
Python 304与200状态码的性能对比分析
很多开发者疑惑，既然浏览器有缓存，为什么还要服务器返回304？直接禁用缓存行不行？通过具体场景对比,差异一目了然。
| 对比维度 | 200 OK (完整响应) | 304 Not Modified |
|---|---|---|
| 响应体大小 | 包含完整HTML/JSON/图片数据 | 零字节（仅头部） |
| 网络传输量 | 高，占用带宽 | 极低，仅传输HTTP头部 |
| 服务器CPU负载 | 高，需序列化数据、渲染模板 | 低，仅需比对哈希或时间戳 |
| 客户端加载速度 | 慢，需下载并解析大文件 | 快，直接使用本地缓存 |
| 适用场景 | 首次访问、资源确实更新时 | 刷新页面、轮询接口、静态资源 |
据工信部相关数据显示，在移动端网络环境下，减少数据传输量对用户体验的提升尤为显著，对于图片、CSS、JS等静态资源，启用304缓存机制可减少
80%以上的无效流量传输。
常见误区：缓存与304的关系
需要澄清的是，304本身不是缓存策略，而是缓存验证策略，浏览器先检查本地缓存是否过期（通过Cache-Control或Expires头决定），如果缓存未过期，浏览器直接使用本地副本，甚至不向服务器发送请求，只有当缓存过期或客户端强制刷新时，才会发送带有验证头的请求,此时服务器才可能返回304。
最佳实践是结合使用强缓存（200 from disk cache）和协商缓存（304），强缓存用于长期不变的静态资源,协商缓存用于频繁更新但变动不频繁的业务数据。
Python 304状态码常见问题解答
Python 304状态码在API开发中是否适用？
完全适用，对于RESTful API，如果客户端需要轮询获取最新状态（如订单状态查询），使用ETag机制可以避免每次返回相同的JSON数据，客户端发送之前的ETag，服务器若发现数据未变，返回304，客户端继续使用本地缓存的状态，从而大幅降低API调用频率和服务器压力。
为什么有时设置了ETag却仍返回200？
这通常由以下原因导致：一是ETag生成逻辑有误，导致每次生成的值不同；二是客户端请求头中未正确携带`If-None-Match`；三是服务器配置了强制刷新或禁用缓存，如设置了`Cache-Control: no-cache`，这会迫使服务器始终验证并返回最新内容，即使内容未变也可能返回200（取决于具体实现）。
Python 304与CDN缓存有何关联？
CDN节点同样遵循HTTP缓存协议，当源站返回304时，CDN节点会更新其缓存的元数据（如ETag），但不会重新回源获取完整资源，如果CDN配置了“忽略源站304，强制回源”的策略，则会增加源站负载，合理配置CDN的缓存验证规则，能让304机制在边缘节点也发挥最大效能。
首发原创文章，作者：王坚，如若转载，请注明出处：https://idctop.com/python-304%e7%8a%b6%e6%80%81%e7%a0%81%e6%98%af%e4%bb%80%e4%b9%88%ef%bc%9fhttp%e7%bc%93%e5%ad%98%e6%9c%ba%e5%88%b6%e8%af%a6%e8%a7%a3/
