PostgreSQL下Flyway执行set变量语句抛出语法错误

• @set TESTINGE = te 不属于PostgreSQL服务端支持的标准SQL语法，是你所用的EBevar SQL客户端自行实现的客户端侧变量指令：这类指令只会在客户端本地完成解析、变量替换，根本不会被发送到PostgreSQL服务端执行，因此在客户端内运行正常。但Flyway、原生JDBC都是直接将SQL原文发送给数据库服务端执行，PostgreSQL服务端无法识别@开头的自定义指令，直接抛出42601语法错误，和你第一组JDBC测试的报错完全一致。
• 第二组JDBC测试中执行SET TESTINGE TO te报错，是因为PostgreSQL原生SET语法仅支持修改数据库已注册的运行时配置参数，不支持直接定义无命名空间的自定义变量，因此会抛出「unrecognized configuration parameter」错误。
• Flyway的核心执行逻辑是通过JDBC驱动拆分迁移脚本中的SQL语句，直接发送给数据库执行，本身不会实现第三方SQL客户端专属的指令解析逻辑，因此脚本中写入客户端专属语法必然执行失败。

方案1：使用Flyway原生占位符（最常用） #

Flyway自带占位符替换能力，变量替换在Flyway侧完成，不会将变量定义语句发送到数据库，适配所有场景：

1. 在Spring Boot配置文件中定义占位符变量，以yml配置为例：

spring:
  flyway:
    placeholders:
      TESTINGE: te # 定义键值对变量
    # 以下为可选配置，默认占位符前后缀为${ 和 }
    placeholder-prefix: "${"
    placeholder-suffix: "}"

2. 在迁移脚本中直接通过占位符语法引用变量即可，示例：

-- 脚本中写占位符
INSERT INTO demo_table(tag) VALUES ('${TESTINGE}');
-- Flyway执行前会自动替换为实际值，最终发给数据库的SQL为：
-- INSERT INTO demo_table(tag) VALUES ('te');

方案2：使用PostgreSQL原生会话级自定义变量 #

如果需要在SQL执行过程中动态定义、修改变量，使用PostgreSQL原生支持的带命名空间的自定义变量语法，完全兼容JDBC和Flyway执行：

1. 定义变量时给自定义变量加独立命名空间（避免和系统内置参数冲突），语法为SET <自定义命名空间>.<变量名> TO '<变量值>';
2. 读取变量时使用current_setting('<命名空间>.<变量名>')函数即可。
   示例脚本：

-- 定义自定义变量，命名空间取业务名比如myapp
SET myapp.testinge TO 'te';
-- 使用变量
INSERT INTO demo_table(tag) VALUES (current_setting('myapp.testinge'));

注意：Flyway占位符是启动迁移时静态替换的，替换后值固定；PostgreSQL会话变量是数据库连接级别的，同一次连接中可动态修改、读取，根据实际业务场景选择即可。

额外提醒：不要将各类SQL客户端的专属指令（比如@set、客户端专属快捷键命令、特殊注释指令）写入Flyway迁移脚本，这类语法不属于数据库标准语法，脱离对应客户端无法正常执行。

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