Play 2.4.3升级至2.5.0编译报错及cache等依赖导入咨询

在Play 2.5.x项目中，你需要在项目根目录的build.sbt文件里的libraryDependencies中添加这些依赖。具体写法如下：

• Cache依赖：推荐用Play官方快捷导入（自动匹配你的Play版本），也可以显式指定版本

  // 方式1：官方快捷导入
  libraryDependencies += play.sbt.PlayImport.cache
  // 方式2：显式指定版本
  libraryDependencies += "com.typesafe.play" %% "play-cache" % "2.5.0"
  

• WS（Web Service）依赖：两种写法任选其一

  libraryDependencies += play.sbt.PlayImport.ws
  // 或者显式版本写法
  libraryDependencies += "com.typesafe.play" %% "play-ws" % "2.5.0"
  

• JDBC依赖：用于数据库操作

  libraryDependencies += play.sbt.PlayImport.jdbc
  // 显式版本写法
  libraryDependencies += "com.typesafe.play" %% "play-jdbc" % "2.5.0"
  

• Specs2测试依赖：添加% Test标识仅在测试阶段生效，建议选用与Play 2.5兼容的版本（比如3.8.6）

  libraryDependencies += "org.specs2" %% "specs2-core" % "3.8.6" % Test
  

如果你的build.sbt里没有显式声明libraryDependencies，可以直接初始化一个依赖序列：

libraryDependencies ++= Seq(
  play.sbt.PlayImport.cache,
  play.sbt.PlayImport.ws,
  play.sbt.PlayImport.jdbc,
  "org.specs2" %% "specs2-core" % "3.8.6" % Test
)

你提供的报错信息只显示了项目加载的初始阶段，没有完整的错误堆栈，但根据Play 2.4到2.5的升级经验，大概率是以下几个常见问题导致的，你可以逐一排查：

1. 检查sbt版本是否符合要求 #

Play 2.5.x要求使用sbt 0.13.11或更高版本，而Play 2.4.3通常搭配更低的sbt版本。你需要修改project/build.properties文件：

sbt.version=0.13.18  # 选0.13.11+范围内的稳定版本即可

2. 统一所有Play相关依赖的版本 #

升级sbt-plugin后，要确保项目中所有Play模块的版本都是2.5.0，避免依赖冲突。可以在build.sbt中添加强制版本覆盖：

dependencyOverrides ++= Seq(
  "com.typesafe.play" %% "play" % "2.5.0",
  "com.typesafe.play" %% "play-cache" % "2.5.0",
  "com.typesafe.play" %% "play-jdbc" % "2.5.0"
)

3. 处理废弃API的替换 #

Play 2.5做了大量API重构，核心是转向依赖注入：

• 废弃了GlobalSettings，如果你的项目用了这个类，需要替换为ApplicationLoader或者使用模块绑定
• WS的API从WS单例改成了依赖注入的WSClient，需要通过@Inject注解注入使用
• Cache API从EhCachePlugin改成了CacheApi，同样需要依赖注入获取实例

4. 检查其他插件的版本兼容性 #

如果你的项目使用了Play生态的其他插件（比如play-ebean、play-json），这些插件也需要升级到支持Play 2.5的版本。比如play-ebean对应的版本是3.0.x，修改project/plugins.sbt：

addSbtPlugin("com.typesafe.sbt" % "sbt-play-ebean" % "3.0.2")

5. 清理缓存后重新编译 #

旧的编译缓存可能导致奇怪的错误，执行以下命令清理后重新编译：

sbt clean compile

如果以上方法都没解决，建议你提供完整的报错堆栈信息，这样能更精准定位问题。

内容的提问来源于stack exchange，提问作者Manoj S Ramaswamy