Laravel 9+连接Firebird 2.5事务报错：存在活跃事务

环境背景 #

Laravel 9+、PHP 8+、Firebird 2.5，系统同时连接MySQL（默认）和Firebird双数据库，MySQL事务功能正常，Firebird非事务操作正常，但事务闭包/手动调用beginTransaction时抛出「There is already an active transaction」错误。

排查与解决步骤 #

1. 检查Firebird连接的自动提交配置 #

打开config/database.php，找到Firebird连接配置项，确保关闭自动提交：

'firebird' => [
    'driver' => 'firebird',
    'host' => env('FIREBIRD_HOST', 'localhost'),
    'database' => env('FIREBIRD_DATABASE', ''),
    'username' => env('FIREBIRD_USERNAME', 'sysdba'),
    'password' => env('FIREBIRD_PASSWORD', 'masterkey'),
    'charset' => env('FIREBIRD_CHARSET', 'UTF8'),
    'auto_commit' => false, // 必须设置为false，避免隐式开启事务
],

Firebird开启自动提交时，每一次SQL执行都会隐式创建并提交事务，此时手动调用beginTransaction会触发冲突。

2. 验证驱动兼容性 #

确认使用的Firebird数据库驱动版本适配Laravel 9：

• 若用laravel-firebird/laravel-firebird包，确保版本在^3.0及以上；
• 若依赖doctrine/dbal，建议使用^3.0版本。
  旧版本驱动可能存在事务状态判断逻辑bug，导致误报“已有活跃事务”。

3. 排查隐式事务来源 #

在事务代码执行前，添加事务层级检查，确认是否有前置操作已开启事务未关闭：

$fbConn = DB::connection('firebird');
// 输出当前事务层级，0表示无活跃事务
dd('当前事务层级：' . $fbConn->transactionLevel());

// 后续事务代码
$fbConn->transaction(function ($conn) {
    // ...
});

如果输出层级大于0，排查中间件、全局查询日志、前置业务逻辑中是否有未提交/回滚的事务操作。

4. 手动控制事务的兼容写法 #

若闭包事务写法存在兼容性问题，改用手动事务控制并增加状态判断：

$fbConn = DB::connection('firebird');
try {
    // 仅当无活跃事务时开启
    if ($fbConn->transactionLevel() === 0) {
        $fbConn->beginTransaction();
    }

    // 执行你的业务操作（示例）
    $fbConn->table('your_table')->insert([
        // ...
    ]);

    $fbConn->commit();
} catch (\Exception $e) {
    // 仅当有活跃事务时回滚
    if ($fbConn->transactionLevel() > 0) {
        $fbConn->rollBack();
    }
    throw $e;
}

5. 检查Firebird数据库端事务设置 #

使用Firebird的isql工具连接数据库，执行以下命令查看默认事务状态：

SHOW TRANSACTION;

若数据库默认强制开启事务，需调整数据库的事务模式，或在连接时显式指定事务隔离级别。

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