Java应用不直接调用kafka-consumer-groups.sh，该脚本是Kafka自带的Shell工具，用于管理消费者组偏移量；Java可通过ProcessBuilder或Runtime.exec()调用，但更推荐运维侧命令行操作或使用AdminClient编程式重置。
Java 应用本身不直接调用 kafka-consumer-groups.sh，这个脚本是 Kafka 自带的 Shell 工具，运行在 Linux/macOS 终端中，用于管理消费者组偏移量。Java 程序可通过 ProcessBuilder 或 Runtime.exec() 调用该脚本，但更推荐在运维侧使用命令行操作；若需在 Java 服务中动态触发重置（如通过 HTTP 接口），可封装为系统命令调用 —— 但要注意权限、路径、Kafka 集群连通性等前提。
确认 Kafka 安装路径与环境可用性
脚本位于 KAFKA_HOME/bin/kafka-consumer-groups.sh（Linux/macOS）或 KAFKA_HOME/bin/kafka-consumer-groups.bat（Windows）。确保：
-
KAFKA_HOME已正确设置，且bin目录在PATH中 - Java 进程有权限执行该脚本（尤其在容器或受限用户下）
- 目标 Kafka 集群（
--bootstrap-server）网络可达，且消费者组处于活跃或已停止状态（重置要求消费者停止消费）
常用重置偏移量的操作模式
核心命令结构：
kafka-consumer-groups.sh --bootstrap-server <host:port> --group <group-id> --reset-offsets [选项] --execute
关键重置方式包括：
立即学习“Java免费学习笔记（深入）”；
-
按时间重置：例如
--to-earliest（重置到最早）、--to-latest（重置到最新）、--to-datetime "2024-01-01T00:00:00.000" -
按位移重置：例如
--to-offset 100（对所有分区统一设为 100） -
按分区精确指定：用
--topic topic-name:partition=offset，支持多个，如：--to-offset 50 --topic my-topic:0 --topic my-topic:1 -
先预览再执行：去掉
--execute参数，会显示拟重置的分区与偏移量，确认无误后再加--execute
Java 中安全调用脚本的建议做法
不建议在生产 Java 代码中拼接并执行敏感运维命令。若确需集成，应：
- 将脚本路径、参数白名单化（如只允许
--to-earliest或固定时间点），避免注入风险 - 捕获标准输出与错误流，解析返回结果（成功时通常输出
GROUP TOPIC PARTITION NEW-OFFSET表格） - 设置超时（如 30 秒），防止脚本卡死影响主业务线程
- 记录完整操作日志（谁、何时、重置了哪个 group、哪个 topic、哪些 partition）
替代方案：用 AdminClient 编程式管理（推荐）
Kafka 从 2.4+ 开始，AdminClient 支持 alterConsumerGroupOffsets() 方法，无需依赖外部脚本，更可控、可审计：
Map<TopicPartition, OffsetAndMetadata> offsets = new HashMap<>();
offsets.put(new TopicPartition("my-topic", 0), new OffsetAndMetadata(0L));
offsets.put(new TopicPartition("my-topic", 1), new OffsetAndMetadata(0L));
admin.alterConsumerGroupOffsets("my-group", offsets).all().get();
注意：
- 需确保消费者组已停止（否则可能被自动提交覆盖）
- 依赖 Kafka 客户端版本 ≥ 2.4，且集群版本兼容
- 相比 shell 脚本，编程方式更易嵌入监控/治理平台
