Scala SBT项目同包名依赖冲突问题求助：org.slf4j.helpers.MessageFormatter类调用异常

问题分析 #

你遇到的是典型的类路径冲突：org.slf4j.helpers.MessageFormatter类同时存在于slf4j-api（正常直接依赖）和hawtjni-generator（leveldbjni-osx带来的传递依赖）中。JVM加载类时会优先使用类路径里更早出现的版本，这就导致logback-classic调用了错误的实现版本。

有效解决方案 #

1. 强制锁定slf4j-api的优先级（推荐） #

用SBT的dependencyOverrides特性，强制指定slf4j-api的版本，确保它在类路径中被优先加载。在你的build.sbt里添加：

dependencyOverrides += "org.slf4j" % "slf4j-api" % "1.7.25"

这个配置会让SBT确保slf4j-api:1.7.25的jar包在类路径中的顺序优先于其他包含同名类的依赖，JVM自然会先加载它的MessageFormatter类。

2. 调整依赖声明顺序 #

SBT的类路径顺序会部分受build.sbt中依赖声明顺序影响。尝试把slf4j-api和logback-classic的声明放在leveldbjni-osx之前：

libraryDependencies ++= Seq(
  "org.slf4j" % "slf4j-api" % "1.7.25",
  "ch.qos.logback" % "logback-classic" % "1.2.3",
  "com.ltonetwork" % "leveldbjni-osx" % "99-master-SNAPSHOT"
)

这样SBT大概率会把slf4j-api的jar放在类路径更靠前的位置，让JVM先加载它的类。

3. 针对性排除冗余依赖（进阶） #

如果hawtjni-generator对项目功能没有直接影响，可以直接在引入leveldbjni-osx时排除它：

libraryDependencies += "com.ltonetwork" % "leveldbjni-osx" % "99-master-SNAPSHOT" exclude (
  "org.fusesource.hawtjni", "hawtjni-generator"
)

要是排除整个hawtjni-generator会影响leveldbjni-osx的功能，就用sbt-assembly插件过滤掉冲突类（仅在打包fat jar时生效）：

// 先添加sbt-assembly插件到project/plugins.sbt
addSbtPlugin("com.eed3si9n" % "sbt-assembly" % "1.2.0")

// 然后在build.sbt中配置合并策略
assemblyMergeStrategy in assembly := {
  case PathList("org", "slf4j", "helpers", "MessageFormatter.class") => MergeStrategy.first
}

4. 验证修复效果 #

运行以下SBT命令确认修复情况：

• show fullClasspath：查看类路径的jar顺序，确保slf4j-api-1.7.25.jar在hawtjni-generator-1.18.jar之前。
• dependencyTree：再次检查依赖树，确认没有意外的版本冲突。

为什么之前的方法无效？ #

• 清理IDE缓存只能解决IDE识别问题，但JVM运行时的类加载是基于SBT生成的类路径，无法解决根本冲突。
• 错误的排除规则：你之前给其他依赖加排除，但冲突根源是leveldbjni-osx引入的hawtjni-generator，应该针对这个依赖调整，而非其他依赖。

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