Traefik如何基于请求JSON Body参数配置rateLimit限流规则

• 原配置使用的Query(sender=Tester)规则仅能匹配URL查询参数（即URL中?后拼接的参数，例如http://127.0.0.1/?sender=Tester），完全不会解析POST请求体中的JSON字段，所有携带JSON body的POST请求都无法匹配该路由。
• 配置中仅设置了这一条带匹配规则的路由，所有不满足匹配条件的请求没有对应承接路由，直接返回404。
• Traefik原生默认不支持直接读取JSON请求体字段作为路由、限流的匹配条件，需要借助插件或前置网关逻辑实现需求。

方案1：基于Traefik插件实现（纯配置，无需额外服务） #

通过body解析插件提取JSON中的指定字段写入请求头，再基于请求头做路由分流和限流，步骤如下：

1. 修改Traefik静态配置，在实验性功能板块启用插件市场中的body-inspect插件，该插件作用是解析请求体中的JSON字段，将字段值写入自定义请求头供后续规则匹配。
2. 配置所需的两类中间件：

[http.middlewares]
  # 提取JSON请求体中sender字段的值，写入请求头X-Sender
  [http.middlewares.extract-sender.plugin.bodyinspect]
    [http.middlewares.extract-sender.plugin.bodyinspect.rules]
      [http.middlewares.extract-sender.plugin.bodyinspect.rules.json]
        sender = "X-Sender"
  # 限流规则：100rps
  [http.middlewares.test-ratelimit.rateLimit]
    average = 100
    burst = 100
    period = "1s"

3. 配置两条路由，通过优先级控制匹配顺序：

[http.routers]
  # 高优先级路由：匹配sender=Tester的请求，挂载限流中间件
  [http.routers.whoami_ratelimited]
    rule = "Host(`whoami.docker.localhost`) && Headers(`X-Sender`, `Tester`)"
    service = "whoami"
    entrypoints = ["web"]
    middlewares = ["extract-sender", "test-ratelimit"]
    priority = 100
  # 低优先级兜底路由：匹配其余所有请求，无限流
  [http.routers.whoami_normal]
    rule = "Host(`whoami.docker.localhost`)"
    service = "whoami"
    entrypoints = ["web"]
    middlewares = ["extract-sender"]
    priority = 10

注意：限流路由必须设置更高的优先级，否则会被兜底路由提前匹配，导致限流规则不生效。

方案2：前置网关自定义逻辑实现（适合高流量生产场景） #

如果不想使用第三方Traefik插件，可以在Traefik和后端服务之间增加一层OpenResty网关，通过Lua脚本实现逻辑：

• 读取并解析POST请求体中的JSON内容，提取sender字段值
• 若字段值为Tester，则对该请求执行令牌桶限流，阈值设置为100rps
• 其余请求直接转发，不做限流处理
  该方案性能优于插件方案，适合QPS较高的生产环境使用。

• 不要使用Query()规则匹配POST请求体参数，该规则仅作用于URL查询字符串，和请求体无关
• 配置分流路由时必须设置兜底路由承接所有正常请求，否则会出现大量404错误
• rateLimit中间件建议显式配置period和burst参数，避免默认值不符合预期。

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