Scala多平台构建因顶级定义重复报错，该如何排查解决？

这个冲突是因为项目同时引入了JVM和JS平台的portable-scala-reflect包，导致同一个注解类在类路径中重复存在。以下是具体解决步骤：

• 改用多平台统一依赖声明
  在build.sbt中，不要分别为JVM、JS子项目单独添加该依赖，使用Scala多平台专属的%%%依赖符号，让sbt自动匹配对应平台的正确jar包：

  libraryDependencies += "org.portable-scala" %%% "portable-scala-reflect" % "1.1.2"
  

• 移除手动添加的平台专属依赖
  检查你的build.sbt，找到并删除以下两类单独声明的依赖：

  • JVM平台的"org.portable-scala" % "portable-scala-reflect" % "1.1.2"
  • JS平台的"org.portable-scala" % "portable-scala-reflect_sjs1_2.13" % "1.1.2"

• 清理缓存并重新构建
  执行命令清除旧的构建缓存，避免残留冲突文件：

  sbt clean
  

  然后重新执行构建：

  sbt compile
  

• 排查间接依赖（可选）
  如果冲突依然存在，用依赖树命令查看是否有其他依赖间接引入了冲突包：

  sbt dependencyTree
  

  找到来源后，使用exclude规则排除重复的平台版本，例如排除JVM版本的间接依赖：

  libraryDependencies += "冲突来源的依赖坐标" % "版本" exclude ("org.portable-scala", "portable-scala-reflect_2.13")
  

内容的提问来源于stack exchange，提问作者Nabil A.