0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

Springの@TransactionalEventListenerでつまずくAFTER_COMMITとDB更新

0
Posted at

個人開発しているもの

日々の開発で得た知識を発信しながら、「あったら便利」「作ってみたい」と思ったアイデアを形にしています。

これまでに、グループ旅行アプリ Trip Supporter、スコア管理サービス PointPia、リアルタイム共有サービス JustNow などを開発しました。

さらに、刺繍やオリジナルキャラクターを中心としたアパレルブランド MAD TOMMY WITH... も運営しています。

開発したサービスや技術記事は chicchi.work で紹介しています。

「注文のDB更新が成功した場合だけ通知処理を実行したい」。Springでは@TransactionalEventListenerでトランザクションの確定に連動したイベントを扱えます。ただし、コミット後のリスナーからさらにDB更新すると、期待した変更が保存されない場合がある点に注意が必要です。

この記事では、AFTER_COMMITが何を保証するのか、REQUIRES_NEWをどこに置くのか、通知の取りこぼしまで防ぎたいときは何を選ぶのかを整理します。2026年11月9日にSpring Frameworkの公式ドキュメントを確認しました。コードはSpringの同期イベント・JDBCトランザクション・PostgreSQLを想定した説明用サンプルです。

1. 「DB更新成功後に実行したい」ときの基本

トランザクションとは、複数のDB操作を「まとめて確定するか、まとめて取り消すか」の単位です。@Transactionalはその境界を宣言するSpringのアノテーション(メソッドなどに動作を指定する印)です。

まずは注文の支払状態を変更してイベントを発行します。

import org.springframework.context.ApplicationEventPublisher;
import org.springframework.jdbc.core.JdbcTemplate;
import org.springframework.stereotype.Service;
import org.springframework.transaction.annotation.Transactional;

record OrderPaid(long orderId) {}

@Service
public class OrderService {
    private final JdbcTemplate jdbc;
    private final ApplicationEventPublisher events;

    public OrderService(JdbcTemplate jdbc, ApplicationEventPublisher events) {
        this.jdbc = jdbc;
        this.events = events;
    }

    @Transactional
    public void markPaid(long orderId) {
        int changed = jdbc.update(
            "UPDATE orders SET status = 'PAID' " +
            "WHERE id = ? AND status = 'PENDING'",
            orderId
        );
        if (changed != 1) {
            throw new IllegalStateException("対象注文がないか、既に処理済みです");
        }
        events.publishEvent(new OrderPaid(orderId));
    }
}

JdbcTemplateはSQL実行を簡単にするSpringの部品、ApplicationEventPublisherはアプリケーション内部へイベントを通知する仕組みです。このpublishEvent自体は外部のメッセージキューへ永続化する操作ではありません。

@TransactionalEventListenerを指定すると、発行されたイベントを特定のトランザクション段階で受け取れます。

phase いつ動くか 主な用途
BEFORE_COMMIT コミット前 確定前のチェックなど
AFTER_COMMIT 正常コミット後(デフォルト) 成功後に行う処理
AFTER_ROLLBACK ロールバック後 失敗時の後処理
AFTER_COMPLETION コミット・ロールバック後 結果にかかわらない後処理

AFTER_COMMITのリスナーは元のDBトランザクションが正常にコミットされた後に実行されます。元処理がロールバックされた場合は、この段階のリスナーは実行されません。

2. ハマりどころ:AFTER_COMMITから普通にDBへ保存する

例えば次のようなリスナーです。

@Component
public class OrderPaidListener {
    private final NotificationJobRepository repository;

    public OrderPaidListener(NotificationJobRepository repository) {
        this.repository = repository;
    }

    @TransactionalEventListener(phase = TransactionPhase.AFTER_COMMIT)
    public void on(OrderPaid event) {
        repository.save(event.orderId()); // これだけでは危険
    }
}

NotificationJobRepositoryは説明用のDB保存部品です。問題はsaveの中身よりもトランザクションの境界にあります。

Spring公式のTransactionPhaseの説明では、AFTER_COMMIT時点ではコミットは終わっていても、元のトランザクションに紐付いたDBリソースがまだアクセス可能な場合があり、そこで元のトランザクションに参加した変更は追加コミットされないと注意されています。

つまり「メソッドが例外なく終わった」だけでは「通知ジョブが永続化された」とは判断できません。@TransactionalのデフォルトであるREQUIRED(既存トランザクションがあれば参加する)を呼ぶだけでも、この問題を避けられるとは限りません。

3. DB保存が必要なら別BeanでREQUIRES_NEWを使う

REQUIRES_NEWは独立した物理トランザクションを開始する伝播設定です。「伝播」とは、既にトランザクションがあるとき、呼び先を同じ単位に含めるか別の単位にするかというルールです。

リスナーからDBを保存する処理を**別のSpring Bean(Springが管理するオブジェクト)**に分離します。

import org.springframework.stereotype.Component;
import org.springframework.transaction.event.TransactionPhase;
import org.springframework.transaction.event.TransactionalEventListener;

@Component
public class OrderPaidListener {
    private final NotificationJobService jobService;

    public OrderPaidListener(NotificationJobService jobService) {
        this.jobService = jobService;
    }

    @TransactionalEventListener(phase = TransactionPhase.AFTER_COMMIT)
    public void on(OrderPaid event) {
        jobService.enqueue(event.orderId());
    }
}
import org.springframework.jdbc.core.JdbcTemplate;
import org.springframework.stereotype.Service;
import org.springframework.transaction.annotation.Propagation;
import org.springframework.transaction.annotation.Transactional;

@Service
public class NotificationJobService {
    private final JdbcTemplate jdbc;

    public NotificationJobService(JdbcTemplate jdbc) {
        this.jdbc = jdbc;
    }

    @Transactional(propagation = Propagation.REQUIRES_NEW)
    public void enqueue(long orderId) {
        jdbc.update(
            "INSERT INTO notification_jobs (order_id) VALUES (?) " +
            "ON CONFLICT (order_id) DO NOTHING",
            orderId
        );
    }
}

このSQLではnotification_jobs.order_idに一意制約(同じ値を重複登録させない制約)があることを前提にしています。PostgreSQLのON CONFLICT ... DO NOTHINGは、一意制約に衝突したとき、重複行の追加を行わないための構文です。テーブル定義の例は次のとおりです。

CREATE TABLE notification_jobs (
    order_id bigint PRIMARY KEY
);

PRIMARY KEYが一意制約を含みます。再実行時にも同じ注文の通知ジョブが増えないようにする意図です。実運用では状態・作成日時・再試行回数なども必要に応じて追加します。

なぜ別のクラスにしたのか

Springで一般的なプロキシ方式(呼び出しを代理オブジェクトで包む方式)では、同一クラス内でthis.enqueue(...)を呼んでも@Transactionalの設定が適用されないことがあります。リスナー→別Beanの公開メソッドとすることで、Spring管理下のトランザクション処理を通す構成にします。

またREQUIRES_NEWには別のDB接続が必要になり得ます。Spring公式は接続プール(接続の使い回しを管理する仕組み)が枯渇するリスクを説明しています。多数の処理が同時に動くシステムでは接続数と負荷を検証してください。

4. AFTER_COMMITなら通知が必ず成功する、は誤解

ここが運用上もっとも重要です。

AFTER_COMMITは元のトランザクションの成功後に呼ぶタイミングを提供する仕組みであって、イベントの永続化や再配信を保証するキューではありません。

例えば注文のコミット直後にアプリが停止した場合や、NotificationJobService.enqueueがDB接続障害で失敗した場合、注文は確定済みなのに通知ジョブが保存されないことがあります。新しいトランザクションの失敗で、すでに確定した注文を巻き戻せるわけでもありません。

通知の取りこぼしを許容できないなら、Transactional Outboxも検討します。Outboxとは、外部へ通知すべきイベントを「送信待ちレコード」として業務データと同じトランザクション内へ保存し、後続のワーカーが送信する設計です。

@Transactional
public void markPaid(long orderId) {
    int changed = jdbc.update(
        "UPDATE orders SET status = 'PAID' " +
        "WHERE id = ? AND status = 'PENDING'",
        orderId
    );
    if (changed != 1) {
        throw new IllegalStateException("処理済みです");
    }
    // orders更新と同じトランザクションで送信待ちを記録
    jdbc.update(
        "INSERT INTO outbox_events (order_id, event_type) VALUES (?, ?)",
        orderId, "ORDER_PAID"
    );
}

これは概念例です。outbox_eventsの表定義、ワーカーによる未送信行の取得・送信・再試行、重複配信時の冪等性(複数回実行されても結果を壊さない設計)は別途必要です。DBと外部サービスが同じトランザクションになるわけではないため、送信側・受信側の重複対策も組み合わせます。

5. テストで押さえる4つのケース

実装後は「リスナーが呼ばれたか」だけでなく、DBに何が残ったかを検証します。

ケース 期待するDB結果
注文更新が正常コミット 注文が確定し、別トランザクションの通知ジョブも保存
注文更新が例外でロールバック 注文は元の状態、AFTER_COMMITの通知ジョブは作られない
コミット後の通知ジョブ保存が失敗 注文は確定済み。通知失敗を検知・記録し、必要な再試行方針へ
同じイベントを重複処理 一意制約によって通知ジョブを重複登録しない

@TransactionalEventListenerは通常、トランザクションが存在しない場所でイベントを発行すると実行されません。fallbackExecution = trueを指定すれば動かせますが、「コミット後だけ」の意味が変わるため、通常のメソッドと混用する際は注意してください。

なお、コード例はJdbcTemplateに適切なトランザクションマネージャーが設定され、OrderServiceがSpring Beanとして外部から呼ばれる前提です。実アプリでは、ロールバックのテスト自体をトランザクションで包んでコミットしないまま終了するとAFTER_COMMITが発火しないので、テスト境界も確認してください。

6. 使い分けの結論

  • 正常コミット後に軽い処理をする:@TransactionalEventListener(AFTER_COMMIT)。ただし実行・配送の永続保証はない。
  • コミット後に別のDB保存が必要:リスナーから別BeanのREQUIRES_NEW処理を呼び出し、失敗時の扱いを設計する。
  • 注文と通知予定の両方を確実に残したい:同一トランザクションで送信待ちを記録するTransactional Outboxを検討する。

「注文を確定する」ことと「通知を成功させる」ことは、別の成功条件です。どの障害まで耐えたいかを先に決めると、イベントリスナーだけで十分か、永続キューが必要かを判断できます。

参考資料(2026年11月9日確認)

0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?