Spring Boot加载PostgreSQL触发器SQL文件报错问题求助

我之前也碰到过一模一样的问题！Spring Boot的@Sql注解默认用分号作为语句分隔符，但PostgreSQL的触发器函数体里本身就包含分号，这会导致Spring错误地拆分SQL语句，执行到一半就抛出ScriptStatementFailedException。下面是我整理的排查和解决步骤：

1. 优先解决语句分隔符冲突（最常见原因） #

这是绝大多数情况下的罪魁祸首。Spring的脚本初始化工具会把每个分号当成一个独立语句，但PL/pgSQL函数里的分号是函数逻辑的一部分，不能作为语句分隔符。

解决方法： #

• 修改SQL脚本：把原本用分号分隔的独立语句（比如函数定义和触发器创建）换成自定义分隔符，比如//：

CREATE OR REPLACE FUNCTION update_timestamp_trigger()
RETURNS TRIGGER AS $$
BEGIN
  NEW.updated_at = CURRENT_TIMESTAMP;
  RETURN NEW;
END;
$$ LANGUAGE plpgsql;
//
CREATE TRIGGER trigger_update_timestamp
BEFORE UPDATE ON your_table
FOR EACH ROW EXECUTE FUNCTION update_timestamp_trigger();

• 在@Sql注解中指定自定义分隔符：

@Sql(
    value = "classpath:custom_script.sql",
    config = @SqlConfig(separator = "//", commentPrefix = "--")
)

2. 检查测试数据库用户权限 #

虽然你的脚本在PgAdmin里能正常执行，但Spring Boot测试用的数据库用户可能缺少创建函数或触发器的权限。可以在测试初始化脚本中添加赋权语句：

GRANT CREATE FUNCTION, CREATE TRIGGER TO your_test_user;

3. 确认脚本执行顺序与表的存在性 #

如果你的表是由JPA自动生成的，可能@Sql脚本执行时表还没创建完成。可以：

• 在脚本开头添加表存在性检查：

CREATE TABLE IF NOT EXISTS your_table (
    id SERIAL PRIMARY KEY,
    updated_at TIMESTAMP
);

• 调整脚本执行时机，确保在表创建后执行：

@Sql(
    value = "classpath:custom_script.sql",
    executionPhase = Sql.ExecutionPhase.AFTER_TEST_EXECUTION
)

4. 开启日志定位具体错误 #

如果以上方法都没用，开启Spring的调试日志，查看实际执行的SQL语句，就能精准定位哪一行出错了。在application-test.properties中添加：

logging.level.org.springframework.jdbc.datasource.init=DEBUG

通过日志你能看到Spring拆分后的每一条SQL，很容易发现是函数体被截断，还是某个语句权限不足，或者表不存在。

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