Apache Kafka Avro控制台生产者启动报错：缺少必填参数[topic]

问题重现 #

执行以下Avro控制台生产者命令：

./kafka-avro-console-producer --bootstrap-server localhost:9092 --property schema.registry.url=http://localhost:8081/ --topic trainee --property value.schema.id=3

收到错误提示：

Missing required argument "[topic]"
同时返回命令参数说明列表，且部分topic可正常使用，其余均触发该错误。

排查与解决步骤 #

• 检查topic名称的特殊字符
  如果topic名称包含空格、Shell会解析的特殊字符（如$、!、*等），会导致CLI参数解析错误。这类情况需用单引号或双引号包裹topic名称，例如：

  ./kafka-avro-console-producer --bootstrap-server localhost:9092 --property schema.registry.url=http://localhost:8081/ --topic "trainee special" --property value.schema.id=3
  

• 调整参数顺序
  部分Kafka CLI版本对参数顺序敏感，核心参数（如--topic）被穿插在--property之间可能引发解析异常。尝试将--topic提前到命令开头：

  ./kafka-avro-console-producer --topic trainee --bootstrap-server localhost:9092 --property schema.registry.url=http://localhost:8081/ --property value.schema.id=3
  

• 验证topic状态与权限
  错误提示可能存在误导性：若topic不存在且无自动创建权限，部分版本工具会抛出"缺少topic参数"的错误。先检查topic是否存在：

  ./kafka-topics.sh --bootstrap-server localhost:9092 --list
  

  若topic不存在，先手动创建：

  ./kafka-topics.sh --bootstrap-server localhost:9092 --create --topic trainee --partitions 1 --replication-factor 1
  

• 核对工具版本兼容性
  若近期升级过Kafka或Schema Registry，可能存在CLI参数解析逻辑变化。确认三者（Kafka Broker、Schema Registry、CLI工具）版本一致：

  ./kafka-avro-console-producer --version
  

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