nginx 通过 `proxy_buffering`、`proxy_cache` 等指令实现请求体内容的缓冲与缓存。开启 `proxy_buffering on;` 可启用代理响应缓冲，将后端返回的数据暂存至内存或磁盘；配合 `proxy_cache_path` 定义缓存路径及参数，并使用 `proxy_cache` 激活特定 location 的缓存功能，从而实现基于 url 或键值的响应内容缓存。
如何配置 Nginx 以启用代理响应缓冲
在 Nginx 中，代理响应缓冲由 `proxy_buffering` 指令控制。默认情况下，Nginx 会尝试缓冲来自上游服务器的响应。若需显式开启并调整缓冲区大小，可在 `location` 块中设置 `proxy_buffering on;`，并通过 `proxy_buffer_size` 和 `proxy_buffers` 指定初始块大小和缓冲区数量。这些缓冲区位于内存中，当数据超过内存限制时，Nginx 会将多余部分写入临时文件（由 `proxy_temp_file_write_size` 控制），从而避免阻塞上游连接。
server {
listen 80;
server_name example.com;
location /api/ {
proxy_pass http://backend_server;
proxy_buffering on;
proxy_buffer_size 4k;
proxy_buffers 8 4k;
proxy_temp_file_write_size 64k;
}
}
上述配置中，`proxy_buffer_size` 用于存储响应头，而 `proxy_buffers` 定义用于存储响应体的缓冲区。每个缓冲区大小为 4KB，共 8 个，总计 32KB 内存用于缓冲。若响应体更大，超出部分将被写入磁盘临时文件。此机制确保 Nginx 能快速读取上游响应并立即向客户端发送，同时减轻上游服务器压力。
如何为特定路径启用响应内容缓存
要启用响应内容缓存，需先使用 `proxy_cache_path` 定义缓存目录及其管理参数，如 `levels`、`keys_zone`、`max_size` 和 `inactive`。然后在目标 `location` 块中使用 `proxy_cache` 指令引用已定义的缓存区域，并可选地通过 `proxy_cache_key` 自定义缓存键。当请求匹配该 location 时，Nginx 会检查缓存是否命中，若命中则直接返回缓存内容，否则向后端发起请求并将响应存入缓存。
proxy_cache_path /var/cache/nginx levels=1:2 keys_zone=my_cache:10m max_size=1g inactive=60m use_temp_path=off;
server {
listen 80;
server_name example.com;
location /cached/ {
proxy_pass http://backend_server;
proxy_cache my_cache;
proxy_cache_key $scheme$request_method$host$request_uri;
proxy_cache_valid 200 302 10m;
proxy_cache_valid 404 1m;
}
}
在此配置中，`proxy_cache_path` 创建了一个名为 `my_cache` 的共享内存区域，容量为 10MB，最大磁盘占用 1GB，未访问 60 分钟的缓存条目将被清除。`proxy_cache_key` 确保不同 URI 和方法生成独立缓存键。`proxy_cache_valid` 指定不同 HTTP 状态码的缓存有效期。例如，200 和 302 响应缓存 10 分钟，404 缓存 1 分钟。这有效减少了重复请求对后端的冲击。
当请求包含 POST 方法时，Nginx 是否会缓存其响应
默认情况下，Nginx 仅缓存 GET 和 HEAD 方法的响应，POST 请求不会被缓存。这是出于安全考虑，因为 POST 通常用于提交数据，其响应可能具有副作用或依赖请求体内容。若需缓存 POST 响应，必须显式修改 `proxy_cache_methods` 指令，将其扩展至包含 POST。但需注意，此举可能导致不一致的缓存行为，应谨慎使用并确保后端支持幂等性或提供适当的缓存验证机制。
