描述
我们配置了一个proxy模式下的nginx,
upstream backend-test {
server 127.0.0.1:80;
}
server {
listen 8080;
location = /nginx/hwwc/ {
proxy_pass http://backend-test;
proxy_redirect off;
}
location / {
return 500;
}
}
访问 http://t103:8080/nginx/hwwc/ 可以正常访问80端口的服务. 访问curl http://t103:8080/nginx/hwwc 的时候, 会返回301重定向. 他们的区别是结尾是否有一个"/"
┬─[tong@T7:~/Src/thirdparty/nginx.git]─[07:13:29 PM]
╰─>$ curl http://t103:8080/nginx/hwwc
<html>
<head><title>301 Moved Permanently</title></head>
<body bgcolor="white">
<center><h1>301 Moved Permanently</h1></center>
<hr><center>nginx/1.12.2</center>
</body>
</html>
结论: 这个问题的原因是, 访问hwwc时触发了nginx的auto_rediect功能. 将请求重定向到了hwwc/
分析过程如下:
调试日志
首先打开nginx的调试. 使用--with-debug选项编译的nginx可以打开此功能, 如下配置:
参考:https://nginx.org/en/docs/ngx_core_module.html#debug_connection
events {
debug_connection 192.168.7.1;
}
在error.log里能看见如下日志: (摘录关键内容)
... ...
2019/09/02 18:37:49 [debug] 23137#0: *70 test location: "/"
2019/09/02 18:37:49 [debug] 23137#0: *70 test location: "nginx/hwwc/"
2019/09/02 18:37:49 [debug] 23137#0: *70 using configuration "=/nginx/hwwc/"
2019/09/02 18:37:49 [debug] 23137#0: *70 http cl:-1 max:1048576
2019/09/02 18:37:49 [debug] 23137#0: *70 http finalize request: 301, "/nginx/hwwc?" a:1, c:1
2019/09/02 18:37:49 [debug] 23137#0: *70 http special response: 301, "/nginx/hwwc?"
2019/09/02 18:37:49 [debug] 23137#0: *70 http set discard body
2019/09/02 18:37:49 [debug] 23137#0: *70 xslt filter header
2019/09/02 18:37:49 [debug] 23137#0: *70 posix_memalign: 000055830C085F80:4096 @16
2019/09/02 18:37:49 [debug] 23137#0: *70 HTTP/1.1 301 Moved Permanently
Server: nginx/1.12.2
Date: Mon, 02 Sep 2019 10:37:49 GMT
Content-Type: text/html
Content-Length: 185
Location: http://t103:8080/nginx/hwwc/
Connection: keep-alive
通过上边的日志我们能见到, nginx在location"/" 与 "nginx/hwwc/" 中进行选择, 最后选择了"nginx/hwwc/", 然后触发了301.
代码分析
一
根据上边的日志, 我们通过主要的的关键字"test location" 和 "using configuration" 定位到如下代码:
nginx/src/http/ngx_http_core_module.c::ngx_http_core_find_static_location():1443
if (len + 1 == (size_t) node->len && node->auto_redirect) {
r->loc_conf = (node->exact) ? node->exact->loc_conf:
node->inclusive->loc_conf;
rv = NGX_DONE;
}
在location选择的时候, 如果URI字符串比location字符串多了一个字符(也就是"/"),并且前边的字符都相等, 同时node结构体的变量auto_redirect也是true的. 就认为命中了当前location.
也就是说URI"hwwc"会在精确匹配location的检查中匹配到location"hwwc/"
二
nginx/src/http/ngx_http.c::ngx_http_create_locations_tree():1093
node->auto_redirect = (u_char) ((lq->exact && lq->exact->auto_redirect)
|| (lq->inclusive && lq->inclusive->auto_redirect));
nginx的全局代码中有两个auto_redirect, 一个是(一)中的node结构体. 另一个是config中的结构体.
node中的结构体会通过config中的设置进行赋值. 如该段代码所述.
三
nginx/src/http/modules/ngx_http_proxy_module.c::ngx_http_proxy_pass():3594
if (clcf->name.len && clcf->name.data[clcf->name.len - 1] == '/') {
clcf->auto_redirect = 1;
}
config中的auto_redirect, 当检测到location以"/"结尾的时候, 会自动赋值auto_redirect 为true, 并通过(二)传递到运行时.
这段赋值代码, 除了在proxy模块中, 同时还存在与fastcgi, grpc, memcached, scgi, uwsgi模块中.
四
nginx/src/http/ngx_http_core_module.h
struct ngx_http_core_loc_conf_s {
... ...
unsigned auto_redirect:1;
ngx_flag_t absolute_redirect; /* absolute_redirect */
ngx_flag_t server_name_in_redirect; /* server_name_in_redirect */
ngx_flag_t port_in_redirect; /* port_in_redirect */
... ...
}
nginx/src/http/ngx_http_core_module.c
static ngx_command_t ngx_http_core_commands[] = {
{ ngx_string("absolute_redirect"),
... ...
{ ngx_string("server_name_in_redirect"),
... ...
{ ngx_string("port_in_redirect"),
... ...
}
分析配置流程中的代码. location中与redirect相关的配置大概一共有四个, 其中auto_redirect是不可配置的. 其他三个可以通过配置文件设置. 但是均与auto_redirect没有逻辑耦合关系.
综上. auto_redirect是不可通过配置修改的. 由URI的结尾是否有"/"自动设置.
如果要改变这一行为,需要进行代码基本的修改。
通过官方文档印证
查看, ngnix的官方文档, 针对该问题有如下的描述,和解决建议. 与我们通过源码进行的分析保持一直:
https://nginx.org/en/docs/http/ngx_http_core_module.html#location
如果, 要屏蔽这个重定向问题, 应该明确的对不带"/"的location进行指定.
另外,
除了以上提到的几个配置, 还有一个proxy_redirect的配置.
https://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_redirect
通过简单测试,发现当前场景下,该配置并不生效. 应该是由于我们这个场景下个redirect使用proxy发的. 而这个配置项
是针对backend发来的redirect消息进行修改的.
以后可以读一下代码进行确认. 目前先通过测试做这样的黑盒判断.
其他
serverfault上也有人提出同样的问题. 结论与我们的分析一致.