AWS ECS环境下Hazelcast集群配置失败排查求助

1. 定位代码空指针根源 #

• 直接查看HazelcastConfiguration.java第40行代码，确认哪个对象未初始化就被调用。大概率是Hazelcast发现策略相关配置对象为空，比如ECS发现插件的参数未正确注入。
• 检查PlayerServerApplication.java第86行的启动逻辑，确认初始化Hazelcast实例时的参数传递是否完整。

2. 校验Hazelcast ECS发现插件配置 #

• 确认项目已引入兼容版本的Hazelcast AWS ECS发现插件依赖（如com.hazelcast:hazelcast-aws），版本需与Hazelcast核心版本匹配。
• 检查Hazelcast配置文件或代码中的发现策略配置：
  • 确保discovery-strategies类型为com.hazelcast.aws.AwsEcsDiscoveryStrategy
  • 配置正确的cluster名称（需与ECS服务名称一致）
  • 确认region参数已正确设置，或允许插件通过ECS元数据自动获取区域信息

3. 验证ECS awsvpc网络配置 #

• 检查任务安全组规则：允许TCP 5701/5702端口的入站、出站流量（Hazelcast默认通信端口）。
• 确认同集群的ECS任务处于同一个VPC及子网内，跨子网需确保路由打通。
• 确认ECS任务元数据端点正常可用（awsvpc模式默认启用，插件依赖该端点获取自身任务信息）。

4. 修正IAM权限策略 #

• 当前Terraform策略存在语法错误（statement块未闭合），且权限过于宽泛，建议调整为最小必要权限：

  data "aws_iam_policy_document" "hazelcast_policy_doc" {
    statement {
      actions = [
        "ecs:ListTasks",
        "ecs:DescribeTasks",
        "ecs:DescribeServices"
      ]
      resources = ["*"] # 如需更严格，可指定具体ECS服务ARN
    }
  }
  

• 确认该策略已正确关联到ECS任务执行角色或任务角色，保证Hazelcast插件能调用ECS API获取集群内其他任务信息。

5. 排查日志与元数据 #

• 查看ECS任务的完整标准输出/错误日志，获取未被截断的异常栈信息（当前日志跳过了部分栈帧，可能遗漏关键细节）。
• 手动访问ECS任务元数据端点（http://169.254.170.2/v2/metadata），确认能正常返回任务的集群、服务、网络等信息，若无法访问则说明网络配置存在问题。

6. 分步验证功能 #

• 先禁用集群发现，启动单节点Hazelcast实例，确认基础功能正常，排除Hazelcast核心配置错误。
• 单节点运行正常后，逐步启用ECS发现策略，观察是否复现空指针异常。

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