Nginx映射restful路径带中括号报HTTP Status 400 – Bad Request

---

先说结论: 增加以下的nginx配置解决如：

  if ($request_uri ~* ^/mytest/(.*)$) {
      proxy_pass   http://127.0.0.1:8080/mytest/$1; 
  }

详记如下：

1.存在问题

今天下午公司的平台项目有个文件预览的功能，同事说文件预览打不开，一直是没有问题的，经查原因，原来是新上传的文件带了中括号导致，这里用代码模拟一下：

package cn.gzsendi.web.controller;

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
@RequestMapping("/mytest")
public class TestController {
	
    @GetMapping("/{firstFolder}/{secondFolder}/{filePath:.+}")//加上:.+就可以拿到后缀名了
    public String downloadFile(@PathVariable String firstFolder, @PathVariable String secondFolder,@PathVariable String filePath) {
    	String resultStr = firstFolder + "/" + secondFolder + "/" + filePath;
    	System.out.println(resultStr);
        return resultStr;
    }

}

问题1：直接访问如下地址在springboot中就会报HTTP Status 400 – Bad Request
http://127.0.0.1:8080/mytest/contract/GGZ/20220530[1].pdf

问题1解决方法：通过url编码特殊字符后访问
http://127.0.0.1:8080/mytest/contract/GGZ/20220530%5B1%5D.pdf

如果不通过Nginx进行代理的话，到这里问题已经解决了
但我们的项目一般都是要Nginx代理一层后访问，比如
http://127.0.0.1:8888/mytest/contract/GGZ/20220530%5B1%5D.pdf
nginx配置如：

    server {
        listen       8888;
        server_name  localhost;
        
        location / {
            proxy_pass http://127.0.0.1:8080/;
            client_max_body_size  500m;
            proxy_connect_timeout 30;
            proxy_http_version 1.1;
            proxy_send_timeout 300;
            proxy_read_timeout 300;
            proxy_redirect      off;
            proxy_set_header    Host             $http_host;
            proxy_set_header    X-Real-IP        $remote_addr;
            proxy_set_header    X-Real-Port      $remote_port;
            proxy_set_header    X-Forwarded-For  $proxy_add_x_forwarded_for;
        }

    }

发现代理后即使转义了也是不能访问，报400-bad request问题。

2.修改nginx配置解决

解决办法：对请求的url进行重写配置，比如修改上面的/mytest开头的路径
增加如下配置

            if ($request_uri ~* ^/mytest/(.*)$) {
                proxy_pass   http://127.0.0.1:8080/mytest/$1; 
            }

上面的配置要放在proxy_pass之前，完整的配置如下

    server {
        listen       8888;
        server_name  localhost;
        
        location / {
            proxy_pass http://127.0.0.1:8080/;
            if ($request_uri ~* ^/mytest/(.*)$) {
                proxy_pass   http://127.0.0.1:8080/mytest/$1; 
            }
            client_max_body_size  500m;
            proxy_connect_timeout 30;
            proxy_http_version 1.1;
            proxy_send_timeout 300;
            proxy_read_timeout 300;
            proxy_redirect      off;
            proxy_set_header    Host             $http_host;
            proxy_set_header    X-Real-IP        $remote_addr;
            proxy_set_header    X-Real-Port      $remote_port;
            proxy_set_header    X-Forwarded-For  $proxy_add_x_forwarded_for;
        }

    }

说明:

​$request_uri表示url去除$host剩下的部分​，如：
http://127.0.0.1:8888/mytest/contract/GGZ/20220530%5B1%5D.pdf，
去除​$host后：/mytest/contract/GGZ/20220530%5B1%5D.pdf

匹配从左到右分别对应$1、$2、....，
如以上Nginx中匹配的$1 = /contract/GGZ/20220530%5B1%5D.pdf

3.修改配置后正常

修改配置后，重新访问http://127.0.0.1:8888/mytest/contract/GGZ/20220530%5B1%5D.pdf，能正常显示了