kafka-consumer-groups.sh bootstrap-server参数重复报错解决方法

报错Found multiple arguments for option bootstrap-server, but you asked for only one和是否添加--offsets参数无关，本质是命令行解析逻辑识别到--bootstrap-server参数被传入了多个值，常见触发场景如下：

• 从文档、聊天窗口复制命令时，地址段夹带了零宽空格、全角空格等不可见特殊字符，被解析器识别为多个独立参数
• 当前Shell环境提前配置了Kafka相关全局参数，比如KAFKA_OPTS环境变量、客户端默认配置中已经携带了--bootstrap-server配置项，和命令行手动传入的参数重复
• 本地的kafka-consumer-groups.sh或其依赖的kafka-run-class.sh脚本被修改，硬编码了--bootstrap-server传参，和命令行参数冲突
• 传入的服务地址包含Shell可解析的特殊字符（如未转义的空格、&符号），且没有用引号包裹地址段，被Shell自动拆分为多个参数段

按优先级依次操作即可：

1. 不要复制粘贴命令，手动逐字符输入基础命令执行即可。注意--offsets是新版本Kafka中--describe指令的默认行为，不需要额外添加：

   ./kafka-consumer-groups.sh --bootstrap-server my.server.com:9092 --describe --group my-group
   

2. 如果手动输入仍报错，先检查环境变量冲突：执行echo $KAFKA_OPTS、env | grep -i bootstrap查看是否存在预置的bootstrap-server配置，如果有，先临时清空对应环境变量再执行命令：

   unset KAFKA_OPTS
   ./kafka-consumer-groups.sh --bootstrap-server my.server.com:9092 --describe --group my-group
   

3. 检查脚本是否被篡改：执行以下命令搜索两个脚本中是否存在硬编码的bootstrap-server配置，如果有，删除多余的硬编码传参即可：

   grep -n "bootstrap-server" ./kafka-consumer-groups.sh
   grep -n "bootstrap-server" ./kafka-run-class.sh
   

4. 如果需要传入多个Kafka节点地址，用单引号包裹整个地址串，避免Shell拆分参数：

   ./kafka-consumer-groups.sh --bootstrap-server 'kafka1:9092,kafka2:9092,kafka3:9092' --describe --group my-group
   

定位技巧：执行命令前加bash -x可以打印脚本运行时的实际参数拆分结果，能直接看到--bootstrap-server后面被传入了几个值，快速定位多出来的参数来源。

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