Apache Ignite 2.15.0集群执行--snapshot参数报错求助

以下是针对Unexpected argument: --snapshot报错的分步排查方向：

• 验证命令格式正确性
  确认执行的完整命令是否符合Ignite 2.15的规范：正确的快照创建命令应为./control.sh --snapshot create <快照名称>。检查是否误将参数顺序颠倒（比如写成./control.sh create --snapshot <名称>），或是输入时引入了不可见特殊字符，可手动重新输入命令测试。

• 检查集群配置差异
  对比两个集群的核心配置文件（如ignite.xml）：

  • 确认dataStorageConfiguration中是否开启了快照功能：defaultDataRegionConfiguration.setSnapshotEnabled(true)，若目标集群禁用此配置，会导致control.sh无法识别--snapshot参数。
  • 排查是否存在自定义插件或扩展类修改了命令行参数解析逻辑，比如自定义了ControlCommand实现，导致参数处理异常。

• 核对节点运行时类路径
  即使libs目录文件一致，也需确认节点启动时实际加载的类路径：

  • 在节点上执行jps -v查看启动参数中的-classpath，检查是否存在额外Jar包或缺失ignite-core、ignite-control-utility等核心依赖。
  • 排查系统类路径中是否存在旧版本Ignite Jar，导致参数解析逻辑被覆盖。

• 分析control.sh执行流程
  在两个集群上分别执行bash -x control.sh --snapshot help，打印脚本执行的详细流程：

  • 对比脚本加载类、传递参数的过程，看是否因IGNITE_HOME、JAVA_HOME等环境变量差异，导致Jar包加载路径不同。
  • 检查IGNITE_OPTS是否设置了额外参数，干扰命令行解析；确认两个集群的JDK版本一致。

• 检查集群状态与安全配置

  • 执行./control.sh topology确认报错集群的所有节点是否在线且健康，节点异常可能导致命令解析失败。
  • 若集群启用了认证/SSL，尝试在命令中添加--user、--password参数，排查是否因连接权限问题导致参数解析报错。

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