Envoy配置Kafka Broker Filter报错：未知字段id_based_broker_address_rewrite_spec

错误原因 #

启动报错明确指出id_based_broker_address_rewrite_spec在envoy.extensions.filters.network.kafka_broker.v3.KafkaBroker的Protobuf定义中不存在，核心原因是配置字段结构与当前Envoy版本的API规范不匹配：

• 你参考的文档版本可能高于实际使用的Envoy版本，该字段是高版本新增的语法；
• 字段层级结构写错，v3 API中地址重写规则需要嵌套在指定层级下。

解决方案 #

1. 修正配置字段结构（优先推荐） #

根据Envoy v3 API规范，ID-based地址重写规则需要嵌套在broker_address_rewrite_spec.id_based下，而非直接使用id_based_broker_address_rewrite_spec。修改后的Kafka Broker Filter配置示例如下：

- name: envoy.filters.network.kafka_broker
  typed_config:
    "@type": type.googleapis.com/envoy.extensions.filters.network.kafka_broker.v3.KafkaBroker
    stat_prefix: exampleprefix1
    broker_address_rewrite_spec:
      id_based:
        rules:
        - id: 1
          host: xxx.xxx.xxx.xxx
          port: 9092
        - id: 2
          host: yyy.yyy.yyy.yyy
          port: 9092
        - id: 3
          host: zzz.zzz.zzz.zzz
          port: 9092

将所有Listener中的Kafka Broker Filter配置按此结构修改即可。

2. 匹配Envoy版本与文档版本 #

如果修正结构后仍报错，检查当前Envoy版本：

envoy --version

• 若版本低于1.27：该字段是在1.27版本引入的，需升级Envoy：

  sudo apt update && sudo apt install envoy
  

• 若版本高于等于1.27：确认文档版本与Envoy版本一致，避免参考了更高版本的文档语法。

3. 提前验证配置 #

修改完成后，使用以下命令验证配置合法性，避免启动报错：

envoy --mode validate -c envoy-config.yaml

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