srcache_header_buffer_size
指令 `srcache_header_buffer_size` 指定用于在子请求中缓存 HTTP 头的缓冲区大小。
Transparent subrequest-based caching layout for arbitrary NGINX locations
·
httpserverlocationif in location
语法srcache_header_buffer_size size;
默认值none
上下文http, server, location, if in location
参数1
说明
指令 srcache_header_buffer_size 是 NGINX 的基于透明子请求的缓存模块的一部分,该模块允许对任意位置的响应进行缓存。该指令直接影响在发起子请求时为存储 HTTP 头分配的缓冲区大小。在头较大时,设置合适的缓冲区大小可以防止截断或内存问题。该参数接受单个参数,用以定义以字节为单位的大小,也可以用千字节 (K) 或兆字节 (M) 表示。
该指令可在多个上下文中使用,例如 http、server、location,以及 location 内的 if 块中。这种灵活性允许对 NGINX 配置中不同部分的缓存行为进行细粒度控制。需要注意的是,如果定义的大小对于正在处理的头而言过小,可能导致意外结果,例如缓存中的头不完整或损坏。因此,用户应谨慎并根据其应用的具体需求测试不同的大小。
配置示例
server {
location /api {
srcache_header_buffer_size 16k;
}
}⚠
将缓冲区大小设置得过小可能导致头部截断错误。
⚠
对该指令的更改可能不会立即可见,除非清除缓存或重新验证。