Nginx Perl模块使用internal_redirect为何触发文件服务？如何正确重定向？

问题描述 #

我尝试在Nginx的Perl模块中使用internal_redirect功能，简化后的Perl示例代码如下：

sub handler {
   my $r = shift;
   my $original_uri = $r->uri;
   $new_uri = '/hello/world/?foo=heffe';
   $r->internal_redirect($new_uri);
   return OK;
}

对应的Nginx配置：

location /hello/world {
        perl rewrite::handler;
}

发送请求时出现Nginx错误：

[error] 29#29: *1 "/etc/nginx/html/hello/world/index.html" is not found (2: No such file or directory), client:

问题分析 #

为什么Nginx会尝试提供文件服务？ #

调用internal_redirect后返回OK，这个返回值会告知Nginx当前请求已处理完成，进而触发默认的响应流程——查找静态文件。同时，return OK会阻止Nginx发起internal_redirect对应的内部请求匹配，直接进入内容发送阶段，所以才会出现找不到静态文件的错误。

解决方法 #

要实现正确的内部重定向，需修改Perl代码的返回值，将return OK;改为return DECLINED;。这个返回值会让Nginx放弃当前请求流程，重新发起对目标URI的内部请求，匹配对应的location规则：

sub handler {
   my $r = shift;
   my $original_uri = $r->uri;
   # 增加my声明变量，避免全局变量污染
   my $new_uri = '/hello/world/?foo=heffe';
   $r->internal_redirect($new_uri);
   return DECLINED;
}

如果需要避免循环重定向，可以在handler中添加判断逻辑，仅当目标参数不存在时执行重定向：

sub handler {
   my $r = shift;
   my $args = $r->args;
   # 仅当没有foo=heffe参数时才执行重定向
   unless ($args && $args =~ /foo=heffe/) {
       my $new_uri = '/hello/world/?foo=heffe';
       $r->internal_redirect($new_uri);
       return DECLINED;
   }
   # 此处可添加后续响应逻辑
   $r->send_http_header('text/plain');
   $r->print("Hello World with foo=heffe");
   return OK;
}

内容的提问来源于stack exchange，提问作者user2399453