如何解决Akka库依赖解析错误？

问题背景 #

我是Scala新手，正在搭建API，参考Akka官方文档配置了build.sbt依赖：

libraryDependencies ++= Seq(
  "com.typesafe.akka" %% "akka-actor-typed" % akkaVersion,
)

执行sbt run时出现依赖解析错误：sbt.librarymanagement.ResolveException: Error downloading com.typesafe.akka:akka-actor-typed_3:2.9.7，已确认该包及版本存在，怀疑是配置问题，附上完整错误日志寻求解决办法。

完整错误日志 #

Note: Unresolved dependencies path:
[error] sbt.librarymanagement.ResolveException: Error downloading com.typesafe.akka:akka-actor-typed_3:2.9.7
[error]   Not found
[error]   Not found
[error]   not found: /Users/env/.ivy2/localcom.typesafe.akka/akka-actor-typed_3/2.9.7/ivys/ivy.xml
[error]   not found: https://repo1.maven.org/maven2/com/typesafe/akka/akka-actor-typed_3/2.9.7/akka-actor-typed_3-2.9.7.pom
[error]         at lmcoursier.CoursierDependencyResolution.unresolvedWarningOrThrow(CoursierDependencyResolution.scala:346)
[error]         at lmcoursier.CoursierDependencyResolution.$anonfun$update$39(CoursierDependencyResolution.scala:315)
[error]         at scala.util.Either$LeftProjection.map(Either.scala:573)
[error]         at lmcoursier.CoursierDependencyResolution.update(CoursierDependencyResolution.scala:315)
[error]         at sbt.librarymanagement.DependencyResolution.update(DependencyResolution.scala:60)
[error]         at sbt.internal.LibraryManagement$.resolve$1(LibraryManagement.scala:60)
[error]         at sbt.internal.LibraryManagement$.$anonfun$cachedUpdate$12(LibraryManagement.scala:142)
[error]         at sbt.util.Tracked$.$anonfun$lastOutput$1(Tracked.scala:74)
[error]         at sbt.internal.LibraryManagement$.$anonfun$cachedUpdate$11(LibraryManagement.scala:144)
[error]         at sbt.internal.LibraryManagement$.$anonfun$cachedUpdate$11$adapted(LibraryManagement.scala:131)
[error]         at sbt.util.Tracked$.$anonfun$inputChangedW$1(Tracked.scala:220)
[error]         at sbt.internal.LibraryManagement$.cachedUpdate(LibraryManagement.scala:169)
[error]         at sbt.Classpaths$.$anonfun$updateTask0$1(Defaults.scala:3894)
[error]         at scala.Function1.$anonfun$compose$1(Function1.scala:49)
[error]         at sbt.internal.util.$tilde$greater.$anonfun$$u2219$1(TypeFunctions.scala:63)
[error]         at sbt.std.Transform$$anon$4.work(Transform.scala:69)
[error]         at sbt.Execute.$anonfun$submit$2(Execute.scala:283)
[error]         at sbt.internal.util.ErrorHandling$.wideConvert(ErrorHandling.scala:24)
[error]         at sbt.Execute.work(Execute.scala:292)
[error]         at sbt.Execute.$anonfun$submit$1(Execute.scala:283)
[error]         at sbt.ConcurrentRestrictions$$anon$4.$anonfun$submitValid$1(ConcurrentRestrictions.scala:265)
[error]         at sbt.CompletionService$$anon$2.call(CompletionService.scala:65)
[error]         at java.base/java.util.concurrent.FutureTask.run(FutureTask.java:317)
[error]         at java.base/java.util.concurrent.Executors$RunnableAdapter.call(Executors.java:572)
[error]         at java.base/java.util.concurrent.FutureTask.run(FutureTask.java:317)
[error]         at java.base/java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1144)
[error]         at java.base/java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:642)
[error]         at java.base/java.lang.Thread.run(Thread.java:1575)
[error] (update) sbt.librarymanagement.ResolveException: Error downloading com.typesafe.akka:akka-actor-typed_3:2.9.7
[error]   Not found
[error]   Not found
[error]   not found: /Users/env/.ivy2/localcom.typesafe.akka/akka-actor-typed_3/2.9.7/ivys/ivy.xml
[error]   not found: https://repo1.maven.org/maven2/com/typesafe/akka/akka-actor-typed_3/2.9.7/akka-actor-typed_3-2.9.7.pom
[error] Total time: 1 s, completed Oct 23, 2024, 3:02:16 p.m.

排查与解决办法 #

1. 检查Scala版本与Akka版本兼容性 #

错误中akka-actor-typed_3的后缀说明项目使用Scala 3。Akka 2.9.x仅支持Scala 2.13.x和Scala 3.3.x及以上版本，需确认build.sbt中scalaVersion配置的版本是否在兼容范围内。

2. 补充仓库配置（若需） #

部分旧版Akka包未同步到Maven中央仓库，可在build.sbt中添加Typesafe仓库：

resolvers += "Typesafe Releases" at "https://repo.typesafe.com/typesafe/releases/"

3. 清理缓存重新拉取依赖 #

缓存损坏可能导致解析失败，执行以下命令清理缓存并更新依赖：

sbt clean update

4. 验证Akka版本变量 #

确认build.sbt中akkaVersion已正确定义为"2.9.7"，避免因变量未赋值导致版本错误。

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