Envoy RouteMatch query_parameters handling of duplicate query keys
0 reputation · 28 Sept 2025, 18:58 UTC
Designing routing rules that depend on query parameters requires a clear definition of how Envoy interprets a request when the same query key appears multiple times.
Envoy RouteMatch supports a query_parameters list with equality, prefix, suffix, regex, or presence matchers for a single key. The documented matcher types do not specify handling of duplicate keys, and the handling may vary across Envoy releases.
For a stable routing decision, it is important to know the defined semantics rather than implementation assumptions.
Does Envoy specify which value is used when a query key is repeated? Is the matching behavior consistent across recent Envoy versions? Is there a documented way to match against all values for a key?