PHP 8.1.10中PDO事务异常：提交后回滚触发无活跃事务报错

环境与场景 #

基于PHP 8.1.10 + MySQL环境，通过PDO实现数据库迁移操作，逻辑为创建/删除sugar表，并更新migration表的迁移记录，代码如下：

$returnObject = [];
try {
    // (optionally) create the migration table
    require_once(__DIR__ . "/migration-migration.php");
    $connection->beginTransaction();

    // create or drop the sugar table
    $sql = "";
    if ($direction === 0) {
        $sql = "DROP TABLE sugar;";
    } else {
        $sql = "
        CREATE TABLE sugar (
            SugarId INT NOT NULL AUTO_INCREMENT,
            ReadingDate TIMESTAMP NOT NULL,
            Reading DECIMAL(10,1) NOT NULL,
            CONSTRAINT PK_Sugar_SugarId PRIMARY KEY (SugarId)
        );";
    }
    $statement = $connection->prepare($sql);
    $statement->execute();

    // upsert the migration record
    $sql = "
    INSERT INTO migration (MigrationName, IsMigrationUp)
    VALUES ('migration-sugar.php', :direction1)
    ON DUPLICATE KEY
        UPDATE MigrationName = 'migration-sugar.php', IsMigrationUp = :direction2;
    ";
    $statement = $connection->prepare($sql);
    $statement->bindParam(':direction1', $direction);
    $statement->bindParam(':direction2', $direction);
    $statement->execute();

    $connection->commit();
} catch (Exception $exception) {
    $connection->rollBack();
    $returnObject["error"] = "Something unexpected went wrong.";
    $returnObject["exception"] = $exception;
    http_response_code(500);
    echo json_encode($returnObject);
    return;
}
http_response_code(204);
echo json_encode($returnObject);

遇到的问题 #

• 代码总是触发catch块，执行$connection->rollBack();时因$connection->commit();已执行，抛出“无活跃事务”的未捕获PDO异常；
• 移除rollback()后仍返回500响应，但返回的exception对象errorInfo为null，error.log无错误记录（仅添加rollback()时会记录该异常）；
• 原始SQL在phpMyAdmin中执行完全正常。

问题原因与解决方案 #

核心原因 #

1. 未初始化变量触发隐式异常：$returnObject未提前定义，catch块中直接赋值会触发PHP未定义变量的Notice级错误；若PHP配置了将错误转为异常（如开启error_reporting(E_ALL)并通过错误处理器转换），会直接抛出ErrorException进入catch块。此时事务已执行commit()，调用rollBack()自然会触发“无活跃事务”的异常。
2. PDO错误模式未设置为异常模式：默认PDO为静默错误模式，SQL执行失败仅返回false不会抛出PDOException，导致catch块捕获的并非SQL执行异常，而是其他类型的错误，进而出现errorInfo为null的情况。
3. 事务状态未校验：catch块未判断当前是否存在活跃事务就直接调用rollBack()，导致事务已提交后执行回滚操作报错。
4. 引入文件潜在错误：require_once引入的migration-migration.php文件可能存在未被察觉的错误（如未定义变量、SQL执行失败），触发异常进入catch块。

具体修复步骤 #

1. 初始化全局变量：在代码最外层定义$returnObject = [];，避免未定义变量的错误。
2. 配置PDO异常模式：创建PDO连接时强制开启异常错误模式，确保SQL执行失败直接抛出PDOException：

$connection = new PDO($dsn, $username, $password, [
    PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
    PDO::MYSQL_ATTR_INIT_COMMAND => 'SET NAMES utf8mb4'
]);

3. 添加事务状态校验：在回滚前判断事务是否活跃，避免无效回滚：

catch (Exception $exception) {
    if ($connection->inTransaction()) {
        $connection->rollBack();
    }
    // 后续错误处理
}

4. 优化异常信息输出：避免直接序列化Exception对象（存在循环引用导致json_encode失败），提取关键异常信息：

$returnObject["error"] = $exception->getMessage();
$returnObject["code"] = $exception->getCode();
$returnObject["trace"] = $exception->getTraceAsString();
if ($exception instanceof PDOException) {
    $returnObject["errorInfo"] = $exception->errorInfo;
}

5. 排查引入文件：检查migration-migration.php中的代码，确保没有未定义变量、SQL错误等问题，必要时在该文件中也开启异常捕获。

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