Akka版本冲突问题求助：已尝试解决方案仍报错

问题背景 #

项目使用Akka框架，当前依赖配置文件Dependencies.scala内容如下：

import play.sbt.PlayImport.caffeine
import sbt._

object Dependencies {

  val akkaActorVersion      = "2.6.19"


  val akkaCluster       = "com.typesafe.akka"      %% "akka-cluster"        % akkaActorVersion
  val akkaProtobuf      = "com.typesafe.akka"      %% "akka-protobuf"       % akkaActorVersion
  val akkaRemote        = "com.typesafe.akka"      %% "akka-remote"         % akkaActorVersion

  val clientAPIDependencies: Seq[ModuleID] = Seq(
     Dependencies.akkaCluster,
     Dependencies.akkaProtobuf,
     Dependencies.akkaActorType,
    caffeine
  )

}

运行时触发版本冲突错误：

java.lang.IllegalStateException: You are using version 2.6.19 of Akka, but it appears you (perhaps indirectly) also depend on older versions of related artifacts. You can solve this by adding an explicit dependency on version 2.6.19 of the [akka-cluster, akka-protobuf, akka-remote] artifacts to your project. Here's a complete collection of detected artifacts: (2.5.25, [akka-cluster, akka-protobuf, akka-remote]), (2.6.19, [akka-actor, akka-actor-typed, akka-protobuf-v3, akka-serialization-jackson, akka-slf4j, akka-stream]). See also: https://doc.akka.io/docs/akka/current/common/binary-compatibility-rules.html#mixed-versioning-is-not-allowed
[error] 

已尝试添加错误提示中提及的所有Akka依赖，但问题仍未解决。

解决步骤 #

1. 定位旧版本依赖来源 #

执行SBT命令排查间接引入Akka 2.5.25的第三方依赖：

sbt dependencyTree
# 过滤Akka相关依赖，输出更简洁
sbt "dependencyTree | grep akka"

通过输出结果可以明确是哪个依赖（比如Play框架或其他业务库）带入了旧版本Akka组件。

2. 强制统一Akka版本 #

在项目的build.sbt中添加版本强制规则，确保所有Akka相关依赖都使用2.6.19版本：

// 方案1：使用版本协议强制统一
import sbt.librarymanagement.VersionScheme

ThisBuild / libraryDependencySchemes ++= Seq(
  "com.typesafe.akka" %% "akka-cluster" % VersionScheme.Always,
  "com.typesafe.akka" %% "akka-protobuf" % VersionScheme.Always,
  "com.typesafe.akka" %% "akka-remote" % VersionScheme.Always,
  "com.typesafe.akka" %% "akka-actor" % VersionScheme.Always,
  "com.typesafe.akka" %% "akka-actor-typed" % VersionScheme.Always
)

// 方案2：直接覆盖依赖版本
dependencyOverrides ++= Seq(
  "com.typesafe.akka" %% "akka-cluster" % "2.6.19",
  "com.typesafe.akka" %% "akka-protobuf" % "2.6.19",
  "com.typesafe.akka" %% "akka-remote" % "2.6.19"
)

3. 修复依赖配置遗漏 #

当前Dependencies.scala中引用了未定义的akkaActorType，需要补充该依赖定义并修正引用：

// 在Dependencies对象中添加
val akkaActorTyped = "com.typesafe.akka" %% "akka-actor-typed" % akkaActorVersion

// 修正clientAPIDependencies
val clientAPIDependencies: Seq[ModuleID] = Seq(
  akkaCluster,
  akkaProtobuf,
  akkaActorTyped,
  caffeine
)

4. 清理缓存并重新构建 #

执行以下命令清理本地缓存，重新下载依赖并编译：

sbt clean update compile

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