从Akka迁移至Pekko后Kubernetes升级出现根守护进程协议错误

核心原因 #

滚动升级时新旧服务共存，旧Akka服务的ActorSystem地址使用akka://协议，而新Pekko服务默认只识别pekko://协议，当新服务通过集群发现获取到旧服务的akka://地址时，就会抛出协议不匹配的错误。同时K8s服务端点或集群发现缓存未及时清理，导致新服务仍能读取到旧服务的地址信息。

解决方案 #

1. 修改Pekko配置兼容Akka协议前缀 #

通过修改Pekko的Artery协议名称为akka，让新服务的ActorSystem地址使用akka://前缀，与旧服务保持一致，从根源上避免协议不匹配错误。添加以下配置：

pekko {
  remote.artery {
    protocol-name = "akka"  # 将协议名称从默认的pekko改为akka
    canonical.port = 25520 # 可保持与旧服务相同端口，也可根据需求调整
  }
  actor.system-name = "app" # 保留原Actor系统名称，满足网络策略要求
}

Pekko基于Akka 2.6.x分叉，修改协议名称后可与旧Akka服务兼容通信，滚动升级时不会触发协议错误。

2. 缩短集群发现刷新间隔，快速清理旧端点 #

配置Pekko的Kubernetes集群发现组件，缩短端点刷新间隔，让新服务更快感知到旧Pod的删除，避免读取到缓存的旧服务地址：

pekko.discovery.kubernetes-api {
  pod-label-selector = "app=app" # 确保与你的服务标签匹配
  refresh-interval = 2s # 缩短刷新间隔，默认通常为10s
}

3. 蓝绿部署（可选，彻底规避新旧共存风险） #

如果滚动升级风险较高，可采用蓝绿部署方案：

• 先在K8s中部署一套独立的Pekko服务集群，确认运行正常
• 通过Ingress或服务路由，逐步将流量切换到新集群
• 验证新集群稳定后，删除旧的Akka服务集群
  这种方式完全避免新旧服务共存的协议冲突，适合对稳定性要求极高的场景。

4. 清理集群种子节点缓存（若使用种子节点） #

如果服务依赖集群种子节点，需先完成种子节点的替换：

• 先部署1-2个Pekko版本的种子节点，加入集群
• 逐步删除旧的Akka种子节点，确保集群控制权转移到Pekko节点
• 再升级其余服务节点为Pekko版本

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