如何在Spring Boot集成Liquibase时获取SQL脚本的serveroutput

set serveroutput on属于SQL*Plus专属命令，并非标准SQL语法，JDBC驱动无法直接识别执行，因此直接写入Liquibase SQL脚本不会生效。Oracle的serveroutput本质是依赖DBMS_OUTPUT系统包实现，需要JDBC层面主动开启缓冲区并读取输出内容。

核心操作步骤 #

• 首先确认执行SQL的数据库用户有DBMS_OUTPUT包的执行权限，权限不足时需DBA执行授权命令：

  GRANT EXECUTE ON SYS.DBMS_OUTPUT TO your_db_user;
  

• 在业务SQL执行前，先执行标准PL/SQL语句开启输出缓冲区，建议直接写在对应Liquibase变更集的最开头，缓冲区大小设置为NULL代表不限制：

  BEGIN
    DBMS_OUTPUT.ENABLE(NULL);
  END;
  /
  

两种获取输出的方案 #

方案1：变更集内嵌输出读取逻辑（适合获取指定SQL的输出） #

在需要获取输出的SQL块末尾，追加读取缓冲区内容的逻辑，可以选择输出到日志表后后续查询，示例Liquibase XML变更集如下：

<changeSet id="test-serveroutput-001" author="your-name">
  <!-- 开启缓冲区 -->
  <sql dbms="oracle" splitStatements="false">
    BEGIN
      DBMS_OUTPUT.ENABLE(NULL);
    END;
  </sql>
  <!-- 你的业务SQL逻辑，这里写需要执行的PL/SQL -->
  <sql dbms="oracle" splitStatements="false">
    BEGIN
      -- 示例业务逻辑
      UPDATE user_info SET status = 1 WHERE create_time < SYSDATE - 30;
      DBMS_OUTPUT.PUT_LINE('本次更新生效行数：' || SQL%ROWCOUNT);
    END;
  </sql>
  <!-- 读取serveroutput并写入日志表 -->
  <sql dbms="oracle" splitStatements="false">
    DECLARE
      l_line VARCHAR2(32767);
      l_status INTEGER;
    BEGIN
      LOOP
        DBMS_OUTPUT.GET_LINE(l_line, l_status);
        EXIT WHEN l_status != 0;
        INSERT INTO liquibase_exec_log (log_content, create_time) VALUES (l_line, SYSDATE);
      END LOOP;
      COMMIT;
    END;
  </sql>
</changeSet>

Liquibase执行完成后查询liquibase_exec_log表即可拿到对应输出内容。

方案2：全局监听获取所有输出（适合全量日志排查） #

Spring Boot环境下可以自定义Liquibase执行监听器，在每次SQL执行完成后统一读取DBMS_OUTPUT内容并打印到应用日志中：

1. 实现Liquibase的ExecutionListener接口，重写sqlExecuted方法，每次SQL执行完成后调用DBMS_OUTPUT.GET_LINE批量读取输出内容
2. 将自定义监听器注册到Spring容器中的SpringLiquibase实例中，全局生效

常见问题排查 #

• PL/SQL块执行报错时，检查对应sql标签是否添加了splitStatements="false"属性，避免Liquibase将PL/SQL块拆分为多个语句执行
• 输出内容丢失时，检查DBMS_OUTPUT.ENABLE设置的缓冲区大小是否足够，建议直接设置为NULL取消大小限制
• 确认JDBC连接使用的是Oracle官方驱动，不要使用第三方兼容驱动，避免DBMS_OUTPUT调用异常

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