Flyway 7.7.3解析HyperSQL存储过程报Incomplete statement如何处理？

问题根因 #

Flyway 7.x版本对HyperSQL的BEGIN ATOMIC存储过程块语法解析存在缺陷，会误将块内的分号识别为单条语句的结束标记，你之前使用的数据库层面分隔符修改语法无法被Flyway解析器识别，因此会抛出Incomplete statement错误。

可直接落地的解决方法 #

• 方案1：使用Flyway内置的跳过解析注解（最便捷，无需修改原有SQL语法）
  在迁移脚本第一行添加/*+ NO_PARSE */注释，Flyway会直接跳过该文件的语法解析，将完整SQL直接提交给HyperSQL执行，只要你的SQL本身符合HyperSQL语法即可正常运行。
  示例代码：

/*+ NO_PARSE */
CREATE PROCEDURE proc_findByLastname(IN name VARCHAR(30)) READS SQL DATA
  DYNAMIC RESULT SETS 1
  BEGIN ATOMIC
    DECLARE persons_by_lastname_cursor CURSOR FOR 
    SELECT * FROM persons WHERE last_name = name;
    OPEN persons_by_lastname_cursor;
  END;

• 方案2：使用Flyway原生的分隔符设置语法
  之前你使用的DELIMITER是MySQL专属语法，Flyway解析器和HyperSQL都不识别该写法，需要使用Flyway官方指定的分隔符声明语句：

-- 临时修改Flyway解析器的分隔符为 /
SET DELIMITER / ;
CREATE PROCEDURE proc_findByLastname(IN lastname VARCHAR(30)) READS SQL DATA
  DYNAMIC RESULT SETS 1
  BEGIN ATOMIC
    DECLARE persons_by_lastname_cursor CURSOR FOR 
    SELECT * FROM persons WHERE last_name = lastname;
    OPEN persons_by_lastname_cursor;
  END /
-- 改回默认分隔符
SET DELIMITER ; /

• 方案3：升级Flyway版本
  如果业务允许升级依赖，Flyway 7.15.0及以上版本修复了大量HyperSQL存储过程的解析适配问题，升级后原有脚本无需修改即可正常解析执行。

注意事项 #

使用NO_PARSE注解时需提前验证SQL本身的语法正确性，Flyway不会再对该脚本做语法校验。

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