如何为Oracle数据库实现简易迁移脚本支持？

针对你的需求，我来详细说说在Oracle中实现类似Laravel迁移脚本的可行方案，以及需要避开的关键陷阱——毕竟Oracle的事务和DDL处理和SQL Server/Laravel常用的MySQL确实有不少差异。

你的迁移理念完全可以在Oracle中落地，核心思路和Laravel一致：通过migrations表跟踪已执行的脚本，每个脚本先检查是否已执行，未执行则执行逻辑并记录，已执行则跳过。但Oracle的语法和事务规则有自己的特殊性，需要做针对性调整。

首先要确保migrations表的结构可靠，用主键保证脚本名称的唯一性（比单纯查询更能避免并发场景下的重复插入问题）：

CREATE TABLE migrations (
    name VARCHAR2(255) PRIMARY KEY, -- 迁移脚本的唯一标识
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL
);

每个迁移脚本需要用独立的PL/SQL块实现（Oracle中事务和异常处理依赖PL/SQL），单个SQL文件可以包含多个这样的块，用/分隔（这是Oracle客户端执行PL/SQL块的分隔符，类似SQL Server的GO）。

以下是对应你伪代码的Oracle版本实现：

DECLARE
    v_script_name VARCHAR2(255) := 'myUniqueMigrationScript';
    v_is_applied NUMBER;
BEGIN
    -- 检查当前迁移是否已执行
    SELECT COUNT(1)
    INTO v_is_applied
    FROM migrations
    WHERE name = v_script_name;

    IF v_is_applied = 0 THEN
        -- **************************
        -- 这里写你的迁移逻辑：建表、改表、插入数据等
        -- 示例：创建测试表+插入数据
        CREATE TABLE test_users (
            id NUMBER GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
            username VARCHAR2(50) NOT NULL UNIQUE
        );
        INSERT INTO test_users (username) VALUES ('alice');
        -- **************************

        -- 记录迁移已执行
        INSERT INTO migrations (name) VALUES (v_script_name);

        -- 提交事务
        COMMIT;
        DBMS_OUTPUT.PUT_LINE('✅ 成功执行迁移: ' || v_script_name);
    ELSE
        DBMS_OUTPUT.PUT_LINE('⏭️ 跳过迁移: ' || v_script_name || ' (已执行过)');
    END IF;
EXCEPTION
    WHEN OTHERS THEN
        -- 回滚事务（注意：DDL操作无法回滚！）
        ROLLBACK;
        DBMS_OUTPUT.PUT_LINE('❌ 迁移执行失败: ' || v_script_name || ' - 错误信息: ' || SQLERRM);
        RAISE; -- 可选：抛出异常让调用的Java程序感知失败
END;
/

这部分是重点，直接对应你提到的SQL Server的坑，Oracle也有自己的特殊规则：

• DDL语句会隐式提交事务：这是Oracle最容易踩的大坑！任何DDL（CREATE/ALTER/DROP/TRUNCATE等）执行前会自动提交当前事务，执行后也会提交。这意味着：

  • 如果你的迁移中包含DDL，那么DDL之前的操作会被强制提交；
  • 如果DDL执行后后续的DML（比如插入数据）失败，ROLLBACK只能回滚DML，DDL的变更已经永久生效，无法回滚。
  • 避坑建议：如果迁移必须包含DDL，尽量把DDL放在迁移逻辑的最后；或者将DDL单独作为一个迁移脚本，减少影响范围；如果无法避免，要在文档中明确说明DDL无法回滚的限制。

• 事务边界控制：Oracle中没有START TRANSACTION这种显式开启事务的语句，事务从第一个DML/DDL操作开始。每个迁移用独立的PL/SQL块，确保一个迁移的失败不会影响其他迁移的执行。

• 唯一性约束必须加：migrations表的name字段一定要设为主键或唯一约束，这比单纯的COUNT查询更可靠——避免多个进程同时执行同一个迁移时，查询显示未执行，但插入时重复的问题（虽然迁移一般是串行执行，但防患于未然）。

• 异常处理的细节：Oracle的EXCEPTION WHEN OTHERS会捕获所有异常，SQLERRM获取错误信息，SQLCODE获取错误码。注意如果迁移中执行了DDL，异常时的ROLLBACK无法回滚DDL的变更，这一点必须提前告知你的团队。

• 单个SQL文件的多脚本处理：每个迁移PL/SQL块必须用/分隔，否则Oracle客户端会把多个块当成一个执行，导致语法错误。比如在同一个SQL文件中放两个迁移，就要像下面这样：

-- 迁移1：创建test_users表
DECLARE
    v_script_name VARCHAR2(255) := '20240520_create_test_users';
    v_is_applied NUMBER;
BEGIN
    SELECT COUNT(1) INTO v_is_applied FROM migrations WHERE name = v_script_name;
    IF v_is_applied = 0 THEN
        CREATE TABLE test_users (id NUMBER PRIMARY KEY, username VARCHAR2(50));
        INSERT INTO migrations VALUES (v_script_name);
        COMMIT;
        DBMS_OUTPUT.PUT_LINE('Applied: ' || v_script_name);
    ELSE
        DBMS_OUTPUT.PUT_LINE('Skipped: ' || v_script_name);
    END IF;
EXCEPTION
    WHEN OTHERS THEN
        ROLLBACK;
        DBMS_OUTPUT.PUT_LINE('Error: ' || v_script_name || ' - ' || SQLERRM);
        RAISE;
END;
/

-- 迁移2：给test_users加唯一约束
DECLARE
    v_script_name VARCHAR2(255) := '20240521_add_unique_constraint_to_test_users';
    v_is_applied NUMBER;
BEGIN
    SELECT COUNT(1) INTO v_is_applied FROM migrations WHERE name = v_script_name;
    IF v_is_applied = 0 THEN
        ALTER TABLE test_users ADD CONSTRAINT uk_test_users_username UNIQUE (username);
        INSERT INTO migrations VALUES (v_script_name);
        COMMIT;
        DBMS_OUTPUT.PUT_LINE('Applied: ' || v_script_name);
    ELSE
        DBMS_OUTPUT.PUT_LINE('Skipped: ' || v_script_name);
    END IF;
EXCEPTION
    WHEN OTHERS THEN
        ROLLBACK;
        DBMS_OUTPUT.PUT_LINE('Error: ' || v_script_name || ' - ' || SQLERRM);
        RAISE;
END;
/

你提到SQL Server的实现有不少细节问题，Oracle的处理方式不同：

• 不用GO分隔批处理，用/分隔PL/SQL块；
• 不用BEGIN CATCH，用EXCEPTION块处理异常；
• 不用@@TRANCOUNT跟踪事务，Oracle的事务是显式通过COMMIT/ROLLBACK控制的，但要注意DDL的隐式提交；
• Oracle的主键约束比SQL Server的唯一约束更严格，能更好地保证迁移脚本的唯一性。

你的方案在Oracle中完全可行，核心是用PL/SQL块封装每个迁移的逻辑、检查、事务和异常处理。最需要注意的就是DDL的隐式提交问题，这是Oracle独有的特性，一定要提前规划好迁移脚本的结构，避免因为DDL无法回滚导致的数据不一致。

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