如何配置 hash $request_uri 实现集群环境下缓存命中的一致性哈希-Nginx-PHP中文网

直接用 hash $request_uri consistent 可实现 url 级一致性路由，确保相同 uri 总转发至同一后端，提升缓存命中率；$request_uri 含完整路径与原始查询参数，区分大小写且不自动解码，能精确标识逻辑请求，优于 $uri（无参数）、$args（无路径）、$remote_addr（nat 下失效）；配置须满足：必加 consistent、禁用 weight、规范 uri 编码。

如何配置 hash $request_uri 实现集群环境下缓存命中的一致性哈希

直接用 hash $request_uri consistent 就能实现集群中缓存命中的一致性路由，核心是让相同 URL 总落到同一台后端，避免重复回源和缓存碎片。

为什么选 $request_uri 作为哈希键

$request_uri 包含完整路径与原始查询参数（如 /api/goods?id=1001&v=2），区分大小写、不自动解码，能精确代表一次逻辑请求。相比其他变量：

$uri 丢弃 query string，/goods/1 和 /goods/1?from=app 会被分到不同节点，缓存无法共享；
$args 只有参数部分，缺少路径信息，无法区分 /user 和 /order 这类不同接口；
$remote_addr 按 IP 哈希，在 NAT 或多设备场景下易打散，且不保证资源级复用。

基础 upstream 配置要点

必须满足三个硬性条件，否则一致性效果失效：

指令必须写成 hash $request_uri consistent;，consistent 参数不可省略；
所有 server 行不能带 weight=，权重会破坏哈希分布逻辑；
确保前端请求 URI 编码规范，避免未编码空格或中文导致 400；必要时在 server 块加 underscores_in_headers on 并统一编码标准。

配合后端缓存策略生效

仅靠 Nginx 路由不够，后端行为必须对齐：

各后端服务生成的缓存 Key 规则要一致，例如都 strip 掉 utm_* 类追踪参数，否则同一 $request_uri 在不同机器存的是不同内容；
推荐使用共享缓存（如 Redis 集群）而非纯本地内存缓存，避免单机容量瓶颈；
Nginx 层开启 proxy_cache_lock on;，防止缓存未命中时多个相同请求并发回源。