Nginx配置$request_uri与$uri变量的区别

idea's blog 2016-04-05 13:47:42 累计浏览 2,663 次

本机暂存

内容概览

这篇讲的是在Nginx配置中两个极易混淆的变量：$request_uri 与 $uri 的核心区别。文章从一个实际现象出发：浏览器请求同一个地址，这两个变量的值却可能不同。

关键差异在于它们代表的“时间点”。$request_uri 记录的是客户端发起请求时最原始的路径与查询字符串，比如 /my/act?a=1，是“未处理”的状态。而 $uri 则是Nginx处理请求后，最终定位到服务器上资源的路径，比如经过rewrite规则变成 /dir/file.php，它不包含查询参数。

文章特别指出，$request_uri 这个名字本身容易造成误解，因为按标准定义，URI并不包含查询字符串，但它却包含了。理解这个区别至关重要：当你需要记录或匹配客户端最初的原始请求时，应使用 $request_uri；而当你需要基于经过内部重写后的实际资源位置进行逻辑判断或记录日志时，则应使用 $uri。搞混两者可能导致rewrite规则失效或日志记录不准确。

$request_uri

这个变量就是HTTP头部的 path + query_string, 例如 /my/act?a=1.

$uri

这个变量对应到服务器上的一个文件(资源), 所以, 可能不等于 $uri, 因为可能被 rewrite 过. 例如浏览器请求 /my/act?a=1, 对应的资源(URI, $uri) 是 /dir/file.php, 当然, query_string 不属于 uri 的一部分.

由此可见, $request_uri 这个变量的名字是有歧义的, URI 并不包含 query_string, 但这个变量却包含.

同分类推荐文章

等了十年的 Go 链式管道，终于来了：seq 让你像写 Scala 一样写 Go （2026-06-25 18:38:18）
Go 实验特性详解（2026-06-21 10:05:27）
amd64 微架构级别对 Go 程序性能提升多少？（2026-06-21 09:38:49）

查看更多后端文章 →

建议继续学习

配置Nginx＋uwsgi更方便地部署python应用（累计阅读 107,164）
搜狐闪电邮箱的 Nginx/Postfix 使用模式（累计阅读 33,895）
记录一个软中断问题（累计阅读 16,954）
解析nginx负载均衡（累计阅读 16,622）
server日志的路径分析（累计阅读 11,239）
Nginx模块开发入门（累计阅读 11,168）
检查nginx配置，重载配置以及重启的方法（累计阅读 10,895）
Cacti 添加 Nginx 监控（累计阅读 10,641）
fsockopen 异步处理（累计阅读 10,343）
使用Squid缓存视频（累计阅读 10,339）