Nginx网关指南：配置Memcached代理提升API响应查询速度-Nginx-PHP中文网

Nginx代理Memcached通过内存缓存API响应实现低延迟高并发，需启用memcached模块、配置键名规则、使用memcached_pass读取缓存并以error_page 404回退至后端，命中时返回HIT且响应时间显著降低。

nginx网关指南：配置memcached代理提升api响应查询速度

用Nginx代理Memcached，本质是把高频读取的API响应结果缓存在内存中，让Nginx在转发请求前先查缓存——命中则直接返回，跳过后端服务，显著降低延迟和负载。

确认Nginx已启用memcached模块

Nginx需编译时包含--with-http_memcached_module，或使用主流发行版预编译包（如Ubuntu的nginx-full）。运行以下命令验证：

nginx -V 2>&1 | grep -o with-http_memcached_module

若无输出，需重新编译或换用支持该模块的版本。注意：OpenResty默认支持，但标准Nginx Mainline/Alpine镜像可能不带此模块。

配置Memcached服务与键名规则

Memcached本身无需特殊配置，但Nginx访问它依赖两点：

确保Memcached监听在Nginx可访问的地址（如0.0.0.0:11211），防火墙放行端口
缓存键（key）必须与API请求特征严格对应，常用组合：
$scheme$host$request_uri（含查询参数）或自定义哈希如md5($host$request_uri)
后端应用写入缓存时，务必使用相同key规则，并设置合理过期时间（如set mykey "data" 60缓存60秒）

在location中启用memcached_pass代理

在server块内添加一个专用location，将缓存未命中时的兜底行为设为透传到上游（如FastAPI/Node.js）：

location /api/ {
    set $memcached_key "$scheme$host$request_uri";
    memcached_pass 127.0.0.1:11211;
    error_page 404 = @fallback;
<pre class="brush:php;toolbar:false;"># 可选：添加缓存命中标识头便于调试
add_header X-Cache-Status $upstream_cache_status;

}

location @fallback { proxy_pass https://www.php.cn/link/65b5b8d1f89bf53a5713bc3afdd83e9e; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; }

关键点：
– memcached_pass仅负责读取，不写入；写入由后端完成
– error_page 404 = @fallback表示Memcached未找到key时交由@fallback处理
– 不要混用proxy_pass和memcached_pass在同一location，会冲突

验证与调优建议

部署后通过curl观察响应头和耗时：

curl -I https://example.com/api/users?limit=10

关注：
– 首次请求应返回X-Cache-Status: MISS，后续相同请求变为HIT
– 响应时间从后端的~200ms降至（纯内存读取） – 若持续MISS，检查key是否含动态内容（如时间戳、CSRF token）导致不一致 – Memcached内存不足时会LRU淘汰旧数据，监控curr_items和evictions指标