Akka Typed如何获取本地Actor的ActorRef？

方案1：使用Classic适配器调用actorSelection（最直接适配原有逻辑） #

Akka Typed 底层完全兼容 Classic 运行时，你可以通过适配器复用原有actorSelection逻辑，仅针对本地路径使用完全符合安全要求，不会涉及集群跨节点通信：

• Scala 示例：

import akka.actor.typed.scaladsl.adapter._
import scala.concurrent.duration._

// 你的Typed ActorSystem实例
val typedSystem: ActorSystem[Nothing] = ???
// 转成Classic ActorSystem
val classicSystem = typedSystem.toClassic
// 填写已知的本地Actor路径，Akka Management健康检查Actor默认路径为/system/akka-management/health-checks
val selection = classicSystem.actorSelection("/system/akka-management/health-checks")
// 解析获取引用并转成Typed类型
val healthCheckRef = selection.resolveOne(3.seconds).map(_.toTyped[HealthCheckActor.Message])

• Java 示例：

import akka.actor.typed.javadsl.Adapter;
import java.time.Duration;
import java.util.concurrent.CompletionStage;

// 你的Typed ActorSystem实例
ActorSystem<Void> typedSystem = null;
// 转成Classic ActorSystem
akka.actor.ActorSystem classicSystem = Adapter.toClassic(typedSystem);
// 填写已知的本地Actor路径
akka.actor.ActorSelection selection = classicSystem.actorSelection("/system/akka-management/health-checks");
// 解析获取引用并转成Typed类型
CompletionStage<akka.actor.typed.ActorRef<HealthCheckActor.Message>> refStage = 
  selection.resolveOne(Duration.ofSeconds(3))
    .thenApply(ref -> Adapter.toTyped(ref, HealthCheckActor.Message.class));

注意：该方法仅推荐本地路径使用，不要用于跨节点Actor寻址，完全适配你当前的场景需求，不需要向集群注册任何服务，完全在本地完成寻址，不会产生信息泄露问题。

方案2：Receptionist 本地筛选方案（备选） #

如果后续你需要通过Receptionist寻址，可以通过ActorRef的地址属性筛选本地实例，不需要为每个节点单独生成ServiceKey：

// 收到Receptionist的Listing返回后过滤本地实例
val localRef = listing.serviceInstances.find(_.path.address.hasLocalScope)

该方案的缺点是仍然需要将服务注册到集群全局，不符合封装原则，仅作为备选方案。

方案3：本地自定义注册方案（针对自研本地单例Actor） #

如果是你自己维护的本地单例Actor，不需要集群可见，可以在Actor启动后将引用存入本地线程安全容器（如AtomicReference、Guava LoadingCache等），同一ActorSystem内的组件都可以直接读取，性能更高也不会对外泄露。

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