Play Framework升级到2.6.x的填坑记录

为了使用最新的Play WS Api，升级到play 2.6.21

1.配置修改

根据官网的升级指南，修改plugins.sbt文件，更改插件版本号：addSbtPlugin("com.typesafe.play" % "sbt-plugin" % "2.6.21")

build.sbt文件中，把guice和play-json单独加入。

libraryDependencies += guice

libraryDependencies += "com.typesafe.play" %% "play-json" % "2.6.0"

build.sbt中修改依赖库cache和JavaWs的名字为ehcache和ws。修改后如下

libraryDependencies ++= Seq( javaJdbc ,  ehcache , ws)

然后点击菜单View/Tool windwos/SBT打开sbt窗口，点击刷新，然后下载新的依赖包，虽然消耗不少时间，最终顺利完成，没有遇到太大麻烦。

2.运行

修改完配置之后，运行play(使用 sbt run命令)。提示 \views\index.scala.html:18: not found: value welcome。此文件为首页的Twirl模板。

推测可能是2.6版本和2.5版本的首页模板不同，于是到官网下载2.6版本的starter-example，找到views/index.scala.html并覆盖项目的相应文件。再次运行，还是提示同样错误。

这个错误的原因是views.html包下没有welcome对象，views.html.play20包下也没有，据说是因为低版本的play下载了某个低版本依赖包，导致高版本play不再下载新版本的依赖包导致。此问题无法解决，因为这个欢迎页面可有可无，因此最终决定从views/index.scala.html中删除@welcome的调用。编译通过，开发模式下运行没有问题。

3.生产环境部署

和上一版本一样，命令行上 运行sbt dist或者sbt universal:packageBin打包项目为zip文件。复制到服务器上，解压zip文件，运行/bin/xxxx.bat启动web服务器，出现“输入行太长”的错误无法启动web服务器。

直接原因是java -cp "..." 命令太长，超过windows命令行8000字节的限制，导致windows无法执行此命令。这个命令长的部分是 -cp后面指定的jar包文件，因为依赖的jar包太多，sbt把jar文件名全部串接起来放在cp后面，导致这个参数非常长。上一版本还勉强没超过限制，升级到新版本后，依赖包又增加了很多个，导致命令长度超限制。

“输入行太长”错误的一般解决方法是，把bat文件所在路径的基础路径名尽可能缩短，把bat的上两级目录的文件夹名缩短到2个字符，再运行bat文件，这时不再报“输入行太长”错误，但出现新错误“无法找到或者加载主类play.core.server.ProdServerStart”的错误。

一开始怀疑是javac选项或者jdk版本导致的，用了很长时间排查仍然无法解决问题，在stackoverflow上找到的方法也不成功。偶然想到，这个错误是不是也是因为命令长度太长导致的，于是在stackoverflow上找到一个彻底解决命令太长的方法。在build.sbt文件中添加插件LauncherJarPlugin，本来不抱太大希望，想不到运行sbt start竟然成功了，然后打包部署也成功了。添加插件LauncherJarPlugin的语句：

lazy val `xxxx` = (project in file(".")).enablePlugins(PlayJava,LauncherJarPlugin)

至此，play framework2.6.21升级成功完成。