Play Evolutions执行重脚本后状态无法更新为applied的问题求助

问题描述 #

使用Java版Play Framework，通过Evolutions执行常规数据库架构变更时运行正常，但执行涉及500万条记录的大表修改脚本时，状态会卡在applying_up。实际脚本已正确执行，表的预期变更全部完成，但play_evolutions表的last_problem字段为空。

已知状态更新由代码负责，目前数据库变更已成功，但Java线程无法收到完成通知，导致未能更新状态。已检查MySQL RDS的wait_timeout和interactive_timeout，均为28800秒，长于脚本实际执行时间。

环境信息：

• 架构：Java版Play Framework
• 数据库：MySQL RDS
• Play版本：2.8.18（早期版本也存在该问题）
• mysql-connector版本：8.0.30

解决建议 #

1. 拆分大变更脚本 #

将单条大表修改语句拆分为多个小批次执行，避免长时间占用数据库连接导致线程通信异常。示例：

-- 原脚本：ALTER TABLE large_table ADD COLUMN new_col INT;
-- 拆分后（配合分批逻辑执行）
ALTER TABLE large_table ADD COLUMN new_col INT;
-- 若涉及数据更新，分批执行
UPDATE large_table SET new_col = 0 WHERE id BETWEEN 1 AND 100000;
UPDATE large_table SET new_col = 0 WHERE id BETWEEN 100001 AND 200000;
-- 以此类推完成全量更新

2. 调整数据库及连接池超时参数 #

• 检查MySQL RDS的net_read_timeout和net_write_timeout，设置为不小于脚本执行时间的值，避免数据库端主动断开连接。
• 在Play的application.conf中调整JDBC连接池超时配置：

# 延长连接超时和Socket超时
db.default.hikaricp.connectionTimeout=300000
db.default.hikaricp.socketTimeout=300000

3. 手动更新Evolutions状态（临时应急方案） #

确认脚本完全执行生效后，可手动修正play_evolutions表的状态：

UPDATE play_evolutions SET state = 'applied', last_problem = NULL WHERE id = [对应脚本ID];

注意：执行前务必确认脚本已完成所有预期变更，避免后续Evolutions执行逻辑混乱。

4. 启用Evolutions异步执行 #

Play 2.8+支持Evolutions异步执行，在application.conf中开启配置，避免主线程长时间阻塞：

play.evolutions.async=true

5. 优化数据库连接池配置 #

确保连接池有足够资源支撑大脚本执行及状态更新：

• 适当增大连接池最大连接数：

db.default.hikaricp.maximumPoolSize=20

• 调整空闲连接超时时间，避免空闲连接被过早回收：

db.default.hikaricp.idleTimeout=600000

6. 启用MySQL慢查询日志 #

开启MySQL RDS的慢查询日志，记录大脚本的执行细节，排查是否存在隐性锁等待或执行延迟，导致Java线程误判脚本执行状态。

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