tencent cloud

Feedback

Envoy Status Code 431 "Request Header Fields Too Large" Is Returned

Last updated: 2023-12-26 14:32:01
This document is currently invalid. Please refer to the documentation page of the product.
    For an HTTP request in Istio, Envoy returns abnormal status code 431.
    HTTP/1.1 431 Request Header Fields Too Large

    Cause Analysis

    This status code indicates that the size of the HTTP request header exceeds the limit. The default limit is 60 KiB. The limit is determined by the max_request_headers_kb field in the HttpConnectionManager configuration, and its maximum value can be set to 96 KiB.
    
    

    Solution

    The header size limit can be increased by adjusting the max_request_headers_kb field through the EnvoyFilter.
    An EnvoyFilter example (verification in Istio 1.6 has passed):
    apiVersion: networking.istio.io/v1alpha3
    kind: EnvoyFilter
    metadata:
    name: max-header
    namespace: istio-system
    spec:
    configPatches:
    - applyTo: NETWORK_FILTER
    match:
    context: ANY
    listener:
    filterChain:
    filter:
    name: "envoy.http_connection_manager"
    patch:
    operation: MERGE
    value:
    typed_config:
    "@type": "type.googleapis.com/envoy.config.filter.network.http_connection_manager.v2.HttpConnectionManager"
    max_request_headers_kb: 96
    A later version is compatible with the v2 configurations above, but it is recommended to use v3 configurations (verification in Istio 1.8 has passed).
    apiVersion: networking.istio.io/v1alpha3
    kind: EnvoyFilter
    metadata:
    name: max-header
    namespace: istio-system
    spec:
    configPatches:
    - applyTo: NETWORK_FILTER
    match:
    context: ANY
    listener:
    filterChain:
    filter:
    name: "envoy.http_connection_manager"
    patch:
    operation: MERGE
    value:
    typed_config:
    "@type": "type.googleapis.com/envoy.extensions.filters.network.http_connection_manager.v3.HttpConnectionManager"
    max_request_headers_kb: 96
    If the size of a header exceeds 96 KiB, it is recommended to place this part of data in the body.
    Contact Us

    Contact our sales team or business advisors to help your business.

    Technical Support

    Open a ticket if you're looking for further assistance. Our Ticket is 7x24 avaliable.

    7x24 Phone Support