MySQLのエラー『Nested Transaction Not Supported』の解決方法

MySQLで「Nested Transaction Not Supported（ネストされたトランザクションはサポートされていません）」というエラーは、トランザクションの中でさらにトランザクションを開始しようとしたときに発生する。MySQLのInnoDBストレージエンジンではネストされたトランザクションを直接サポートしておらず、開発中のアプリケーションで誤ってトランザクションを多重に開始した場合に問題が起きる。

1. エラーメッセージの例

Error: Nested transaction not supported

このメッセージは、明示的に `BEGIN` や `START TRANSACTION` を実行した後に、再び同じ命令を実行したときに出る。

2. 発生条件

以下のように、トランザクションの中で再度 `BEGIN` を使用した場合に発生する。

START TRANSACTION;
-- 何か処理
START TRANSACTION; -- ←ここでエラー

MySQLではネストされたトランザクションは未対応のため、二重に開始することはできない。

3. SAVEPOINTによる代替手段

MySQLではネストの代替として `SAVEPOINT` を使うことができる。

START TRANSACTION;
-- 何か処理
START TRANSACTION; -- ←ここでエラー

SAVEPOINTはトランザクションの途中状態に名前をつけて復帰できる機能で、擬似的にネスト構造を実現できる。

4. フレームワークによる自動トランザクション管理の影響

LaravelやSpring、DjangoなどのORMでは、既にトランザクションが開始されている状態で自動的に別のトランザクションを始めようとすると、このエラーが発生することがある。

5. アプリケーションコードでの防止方法

既にトランザクションが開始されていないか確認してから開始することで回避可能。

疑似コードの例：

if (!inTransaction()) {
  startTransaction();
}

※MySQLのネイティブSQLにはinTransactionのような関数はないため、アプリケーションレベルで管理する必要がある。

6. トランザクションの状態を確認する方法

現在のトランザクション状態を確認するには、MySQL単体では難しいため、アプリケーション側で状態管理が求められる。たとえば接続クラスにフラグを持たせて管理するなど。

7. ネストトランザクションをサポートする他のDBとの違い

PostgreSQLやSQL Serverなどでは本物のネストトランザクションをサポートしている。MySQLは対応していないため、開発者が設計段階で制御する必要がある。

8. SAVEPOINTとROLLBACK TO SAVEPOINTの使い方

START TRANSACTION;
SAVEPOINT step1;
-- 途中の処理
SAVEPOINT step2;
-- step2の時点に戻す
ROLLBACK TO SAVEPOINT step2;
-- トランザクション全体を完了
COMMIT;

このようにして処理単位で安全に戻れるように設計できる。

9. トランザクションのネストを避けるコード設計

トランザクションを必要とする処理は共通関数にまとめ、呼び出し元がトランザクション管理を行うよう設計することで多重開始を防げる。

10. ORMでネスト風に見える構造を制御する

たとえばLaravelでは `DB::transaction()` 内部で再帰的に呼ばれると、実際にはSAVEPOINTが使われる形に変換されるため安全。ただしMySQLの古いバージョンではそれすらサポートされていないケースがあるため注意。

11. サンプルコード：ネスト風処理をSAVEPOINTで表現

START TRANSACTION;

-- メイン処理
SAVEPOINT level1;
-- サブ処理
SAVEPOINT level2;

-- エラーがあったので戻す
ROLLBACK TO level2;

-- 正常終了
COMMIT;

12. ROLLBACKとSAVEPOINTの併用時の注意

トランザクション全体を中断したい場合は `ROLLBACK`、部分的に戻したい場合は `ROLLBACK TO SAVEPOINT` を使う。混同すると意図しない巻き戻しが起きる。