Envoy Proxy JwtHeader扩展YAML配置失败，请求排查解决

核心问题定位 #

你遇到的"Didn't find a registered implementation for 'envoy.extensions.filters.http' with type URL: 'xxx'"错误，本质是过滤器的name字段和typed_config的类型URL不匹配，或者误用了错误的类型标识。

在Envoy v1.24中，JWT校验的HTTP过滤器正确的name是jwt_authn，对应的类型URL是type.googleapis.com/envoy.extensions.filters.http.jwt_authn.v3.JwtAuthentication。你提到的JwtHeader是配置内部用于指定token提取规则的子字段，并非过滤器本身的类型。

正确配置示例 #

以下是包含基于请求头JWT校验逻辑的完整可运行配置模板：

static_resources:
  listeners:
  - name: listener_0
    address:
      socket_address: { address: 0.0.0.0, port_value: 8080 }
    filter_chains:
    - filters:
      - name: envoy.filters.network.http_connection_manager
        typed_config:
          "@type": type.googleapis.com/envoy.extensions.filters.network.http_connection_manager.v3.HttpConnectionManager
          stat_prefix: ingress_http
          route_config:
            name: local_route
            virtual_hosts:
            - name: local_service
              domains: ["*"]
              routes:
              - match: { prefix: "/" }
                route: { cluster: service_backend }
          http_filters:
          - name: jwt_authn
            typed_config:
              "@type": type.googleapis.com/envoy.extensions.filters.http.jwt_authn.v3.JwtAuthentication
              providers:
                my_jwt_provider:
                  issuer: "your-issuer"
                  local_jwks:
                    inline_string: '{"keys": [{"kty":"RSA","e":"AQAB","n":"..."}]}' # 替换为你的JWKS内容
                  from_headers:
                    - name: "Authorization"
                      value_prefix: "Bearer "
              rules:
                - match: { prefix: "/" }
                  requires:
                    provider_name: "my_jwt_provider"
          - name: envoy.filters.http.router
            typed_config:
              "@type": type.googleapis.com/envoy.extensions.filters.http.router.v3.Router
  clusters:
  - name: service_backend
    connect_timeout: 0.25s
    type: STRICT_DNS
    lb_policy: ROUND_ROBIN
    load_assignment:
      cluster_name: service_backend
      endpoints:
      - lb_endpoints:
        - endpoint:
            address:
              socket_address: { address: backend, port_value: 80 }

关键配置要点 #

• 过滤器name必须准确：HTTP过滤器列表中，JWT校验的name固定为jwt_authn，不能自定义或写错。
• typed_config类型URL正确：必须使用完整的v3版本类型路径，不能省略前缀或使用错误的类型名。
• JWT提取规则配置：通过from_headers指定从目标请求头提取token，示例适配了通用的Authorization: Bearer <token>格式。
• 镜像版本匹配：确保使用的Docker镜像是envoyproxy/envoy:v1.24-latest，避免跨版本导致的过滤器未注册问题。

配置验证方法 #

启动前可以用Envoy自带的校验命令提前排查错误：

docker run --rm -v $(pwd)/your-config.yaml:/config.yaml envoyproxy/envoy:v1.24-latest --mode validate -c /config.yaml

若配置合法，会输出configuration is valid；否则会给出具体错误位置和说明。

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