Play Framework Evolutions语法错误：删除文件后仍报错？

别着急，这个问题我之前帮不少Play框架开发者排查过——核心原因是Play的Evolutions机制会在数据库里留存脚本执行的历史记录，哪怕你删掉本地的evolutions文件，数据库里的残留状态还是会导致启动报错。下面是具体的排查和修复步骤：

• 先查数据库里的play_evolutions表
  Play框架会把所有执行过的数据库脚本记录存在play_evolutions表中，用来追踪脚本的执行状态。你登录MySQL数据库，执行这条命令看看：

  SELECT * FROM play_evolutions;
  

  找到对应你新增的那几个脚本的记录（版本号一般是递增的数字），如果这些记录的状态是failed，或者已经执行了有语法错误的SQL片段，哪怕你删了本地文件，启动时Play还是会盯着这些残留记录不放。

• 清理错误的Evolutions记录
  发现错误记录后，先记得备份数据库（别搞丢数据！），然后可以：

  1. 直接删除这些错误的记录；
  2. 或者把记录的状态改成applied（如果你确定这些脚本不需要再执行了）；
  3. 开发环境下也可以直接清空整个play_evolutions表——不过这样做的话，Play会重新执行所有evolutions脚本，适合测试环境折腾。

• 清掉Play的编译缓存
  有时候本地文件删了，但Play的编译缓存里还留着旧脚本的信息。你可以：

  • 用sbt的话，在终端跑clean命令，再重新compile；
  • 或者直接手动删掉项目根目录下的target文件夹，彻底清空编译生成的文件。

• 检查有没有其他隐藏的SQL脚本
  别忘了排查这些地方：

  • 项目里其他目录的evolutions文件，比如conf/evolutions/prod这类分环境的目录；
  • 代码里有没有硬编码的SQL语句，刚好在第33行附近有语法错误（比如多打了个逗号，导致出现near ')'的报错）。

• 精准定位错误SQL
  要是还找不到问题，就开详细日志看看完整的SQL：
  在application.conf里加一行配置：

  logger.play.db.evolutions=DEBUG
  

  重启服务器后，日志会打印出Play尝试执行的完整SQL，这样就能精准找到第33行到底哪里写错了——哪怕是之前执行过的残留脚本也能揪出来。

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