Docker环境Nginx代理Flask访问/search路由报错排查

故障由两处配置不匹配共同导致：

• Flask的SERVER_NAME配置逻辑存在认知误区：该配置核心作用是支撑Flask内部URL生成、子域名路由匹配，配置后Flask会强制校验请求头中的Host字段必须与配置值完全一致（含端口）。当前配置值为mydomain.com：
  • 直连mydomain.com:8080时，Flask收到的Host头为mydomain.com:8080，与配置值不匹配，直接返回404。
  • Nginx默认转发时不会传递原始请求的Host头，传给Flask的Host值为内网服务地址backend:8080，与配置值完全不符，Flask无法匹配对应路由，返回Cannot GET /search。
• Nginx配置存在语法和逻辑问题：当前写的location /search/?(.*)属于正则匹配规则，但未加~正则修饰符，Nginx会将其识别为普通前缀匹配；同时正则匹配模式下，结尾带斜杠的proxy_pass不会自动完成路径截断拼接，很容易出现路径转发错位。

按以下步骤调整配置即可实现通过mydomain.com经Nginx正常访问服务：

1. 调整Flask配置
   若无强需求（如子域名路由、服务端生成对外绝对URL），直接删除app.config['SERVER_NAME'] = 'mydomain.com'配置即可。这是容器化部署Flask的最优实践，删除后Flask不会强制校验Host头，可自动适配所有代理转发场景。
   若必须保留SERVER_NAME配置，需将其值与Nginx转发传递的Host头保持一致，后续配合Nginx的Host头传递规则即可正常工作。
2. 修正Nginx转发配置
   调整location规则、补全Host头转发、修正路径拼接逻辑，替换为以下配置：

   location ~ ^/search/?(.*) {
       proxy_pass http://backend:8080/search/$1;
   
       proxy_http_version 1.1;
       # 传递原始请求的Host头，保证Flask收到的域名为外部访问的mydomain.com
       proxy_set_header Host $host;
       proxy_set_header Upgrade $http_upgrade;
       proxy_set_header Connection 'upgrade';
       proxy_set_header X-Real-IP $remote_addr;
       proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
       proxy_set_header X-Forwarded-Proto $scheme;
       proxy_pass_request_headers on;
   }
   

   配置调整点说明：
   • 增加~修饰符，声明该location为正则匹配规则，让路径捕获规则生效
   • 新增proxy_set_header Host $host;配置，将外部请求的原始域名传递给后端Flask
   • 正则匹配场景下手动拼接捕获的路径参数到proxy_pass地址，避免路径错位
3. （可选）优化Flask路由兼容规则
   当前路由@app.route('/search', methods=['GET'])仅能匹配/search单一路径，若需要兼容/search/、/search/xxx等/search前缀的所有路径，可将路由修改为：

   @app.route('/search', methods=['GET'])
   @app.route('/search/<path:subpath>', methods=['GET'])
   def search(subpath=''):
       # 原有业务逻辑
   

配置修改完成后重启Nginx与Flask容器，直接访问http://mydomain.com/search即可正常得到响应，所有请求经Nginx转发到后端服务，不会再出现404或路由不匹配的错误。

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