使用sbt assembly打包Play应用Fat Jar：合并策略与加载器异常问题

看起来你遇到的是Play + sbt assembly打包后运行时Guice初始化失败的典型问题——调试时正常是因为IDE/sbt run用的是单独的类加载器和未合并的依赖，而Fat Jar把所有依赖打包到一起，很容易出现配置合并、资源冲突或者SPI文件丢失的情况。下面是几个针对性的解决思路：

1. 修正sbt assembly的MergeStrategy配置 #

Guice和Play框架都依赖一些需要合并的配置文件和SPI服务声明，默认的MergeStrategy可能会覆盖这些文件，导致运行时找不到必要的绑定信息。你需要在build.sbt里调整合并策略：

assemblyMergeStrategy in assembly := {
  // 合并Guice及其他库的SPI服务声明（META-INF/services下的文件）
  case PathList("META-INF", "services", xs @ _*) => MergeStrategy.concat
  // 合并Play的reference.conf和自定义的application.conf，避免配置丢失
  case "reference.conf" => MergeStrategy.concat
  case "application.conf" => MergeStrategy.concat
  // 处理其他META-INF文件，比如LICENSE等，避免冲突
  case PathList("META-INF", xs @ _*) =>
    xs match {
      case "MANIFEST.MF" :: _ => MergeStrategy.discard
      case "INDEX.LIST" :: _ => MergeStrategy.discard
      case "maven" :: _ => MergeStrategy.discard
      case _ => MergeStrategy.first
    }
  // 其他文件用默认策略
  case x =>
    val oldStrategy = (assemblyMergeStrategy in assembly).value
    oldStrategy(x)
}

2. 排查依赖冲突 #

调试时依赖是分离的，不会有版本冲突，但打包成Fat Jar后可能出现多个版本的Guice或Play依赖共存。你可以用sbt dependencyTree命令查看依赖树，找出重复的Guice相关依赖，然后排除掉旧版本：

比如，如果发现有重复的com.google.inject:guice，可以在依赖声明里排除：

libraryDependencies += guice exclude("com.google.inject", "guice")

3. 确保Play的启动类正确 #

运行Fat Jar时，需要确保Play的主类被正确指定。你可以在build.sbt里添加：

mainClass in assembly := Some("play.core.server.ProdServerStart")

这样运行java -jar your-assembly.jar时会自动启动Play的生产环境服务器，而不是依赖默认的主类。

4. 检查资源文件是否被正确打包 #

有时候Guice需要一些类路径下的资源文件（比如自定义的Module配置），你需要确保这些文件被包含在Jar里。可以用jar tf your-assembly.jar命令查看Jar内容，确认application.conf、自定义的Guice Module类、以及META-INF/services下的文件都存在。

如果你的自定义Module是通过SPI注册的（比如在META-INF/services/com.google.inject.Module里声明），一定要确保这个文件在打包时被合并，而不是被覆盖——这也是第一步里MergeStrategy.concat处理services文件的原因。

最后验证 #

修改配置后，重新执行sbt clean assembly生成Jar，然后用java -jar your-assembly.jar启动，应该就能解决Guice初始化的异常了。

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