如何配置API Gateway基于查询字符串参数实现请求路由？

这个方案完全可行，通过API网关基于查询参数做动态路由转发，刚好能解决低代码工具免费版的端点数量限制问题，是非常合适的临时适配方案。

一、Nginx 轻量实现（推荐临时场景） #

Nginx作为反向代理工具，配置简单易部署，适合临时需求：

• 打开Nginx主配置文件（通常是/etc/nginx/nginx.conf或站点配置文件）
• 添加以下/router的location规则，实现基于route参数的转发：

server {
    listen 443 ssl;
    server_name www.example.com;

    location /router {
        # 提取route查询参数
        set $target "/$arg_route";
        # 白名单校验，只允许指定的三个接口
        if ($arg_route !~ ^(methodA|methodB|methodC)$) {
            return 400 "Invalid route parameter";
        }
        # 反向代理到目标接口
        proxy_pass https://www.example.com$target;
        # 保留POST请求的头部和请求体
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_pass_request_body on;
        proxy_pass_request_headers on;
    }
}

• 保存配置后重启Nginx（nginx -s reload），前端请求https://www.example.com/router?route=methodA就会自动转发到对应接口，且完整保留POST请求的内容。

二、云API网关实现（以AWS API Gateway为例） #

如果用云厂商的API网关，配置步骤如下：

1. 创建一个POST类型的API端点/router
2. 在集成请求中，配置映射模板动态生成目标路径：
   • 选择Content-Type为application/json，添加以下VTL模板：

     {
         "requestParameters": {
             "integration.request.path": "$input.params('route')"
         }
     }
     

3. 设置集成目标为https://www.example.com/{route}，并将查询参数route映射到路径变量route
4. 确保启用请求体传递，保存并部署API

三、Kong 开源网关实现 #

1. 创建一个后端服务，指向https://www.example.com
2. 创建POST路由，路径设为/router
3. 添加request-transformer插件，配置路径重写规则：将请求路径从/router修改为/$query_params.route
4. 添加参数白名单，只允许methodA/methodB/methodC三个值，防止非法跳转

关键注意事项 #

• 必须添加参数白名单校验，避免恶意路径（如route=../admin）导致的安全问题
• 测试时要验证POST请求体是否完整传递，部分网关默认可能会丢弃请求体，需手动开启
• 如果现有网关不支持动态路由，单独部署一个轻量Nginx实例做转发是最快捷的临时方案

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