EKS中Akka Cluster Client通过Service Cluster IP通信失败问题排查

从报错日志可明确问题：目标Akka集群的Pod（IP 101.65.16.86，端口25520）收到指向akka://controller@194.169.252.192:8080的握手请求，但该Pod的Akka系统自身声明的本地地址是akka://controller@101.65.16.86:25520，两者地址不匹配，导致握手请求被丢弃。

需将目标Akka集群的Artery参数按以下规则配置：

• Bind参数：绑定到Pod内网地址与Akka remoting实际端口，确保节点能在Pod内部监听连接。
• Canonical参数：设置为Service的名称（或Service IP，推荐用名称保证稳定性）与Service暴露的remoting端口，让外部调用方（如Cluster Client）通过该地址访问集群。

具体配置示例（application.conf） #

akka.remote.artery {
  canonical {
    hostname = "controller"  # 填写你的Akka集群Service名称，Kubernetes内部会自动解析为Service IP
    port = 8080              # Service中配置的remoting端口（对应targetPort 25520）
  }
  bind {
    hostname = "0.0.0.0"     # 绑定到Pod所有网卡，确保能接收Service转发的流量
    port = 25520             # Akka remoting在Pod内部实际监听的端口
  }
}

1. 配置逻辑：
   • Bind参数是Akka节点在Pod内的实际监听地址，必须与Pod内Akka服务端口（25520）一致，绑定0.0.0.0才能接收Kubernetes Service转发的外部流量。
   • Canonical参数是Akka节点对外公布的地址，外部调用方必须使用该地址发起连接，才能让握手请求中的目标地址与节点自身声明的地址匹配，避免被拒绝。
2. 验证步骤：
   • 重启目标Akka集群Pod后，查看启动日志，确认Akka输出的canonical address为akka://controller@<Service IP>:8080。
   • 此时Cluster Client使用akka://controller@194.169.252.192:8080/system/receptionist作为初始联系点，即可与目标集群正常通信。
3. Service配置无需修改：你当前的service-settings.yaml中remoting端口映射（8080 -> 25520）是正确的。

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