現象

Laravel 10のテスト実行時に「There is no active transaction」というエラーが発生した。一般的によく言われている原因とされるtruncateなどのデータベース操作は行っていない状態で発生しており、原因の特定が難しかった。

特徴として：

エラーメッセージからは、アクティブなトランザクションがない状態でトランザクション操作（主にロールバックやコミット）を実行しようとしていることがわかるが、トランザクションの開始と終了が適切に行われているにも関わらずエラーが発生するという矛盾した状況だった。

原因：特定困難も関連要素を特定

「There is no active transaction」エラーの正確な原因特定は困難でしたが、以下の要素が関連していることが判明しました：

単一の明確な原因は特定できず、「環境依存の問題」の典型例と言えます。

今回の「There is no active transaction」エラーに対する解決策は、PHPUnitのプロセス分離機能を適切に設定することでした。

問題が発生するテストクラスに以下のアノテーションを追加しました：

/**
 * @runTestsInSeparateProcesses
 */
class FileImportTest extends TestCase
{
    // テストコード
}

これにより、このテストクラスの各テストメソッドが独立したPHPプロセスで実行されるようになり、テスト間での状態共有が防止されました。

テスト全体に対してphpunit.xmlでプロセス分離を有効にすることも可能ですが、以下のような新たな問題が発生する可能性があります：

<!-- 全テストでプロセス分離を有効にする設定 -->
<phpunit processIsolation="true">

この設定を行うと、今度は以下のようなシリアライズエラーが発生することがありました：

An error occurred inside PHPUnit.
Message: Serialization of 'Illuminate\Http\UploadedFile' is not allowed

これは、テスト間でファイルアップロード機能を使用している場合に特に発生しがちです。

最終的には、以下のアプローチを採用しました：

この方法により、問題のあるテストだけを分離して実行することができ、エラーを解消しつつもテスト全体の実行速度への影響を最小限に抑えることができました。