新人と先輩の会話形式で理解しよう

新人

「Spring Bootのコードを読んでいると、@PostConstructとか@PreDestroyって書いてあるのを見かけるんですが、正直いつ使われているのか分からなくて……」

先輩

「確かに最初は分かりにくいよね。これはBeanが作られた後や、アプリが終わるときに動く処理を書くためのものなんだ。」

新人

「Beanが作られた後、っていうのがもうよく分からなくて……」

先輩

「じゃあまずは、Beanとライフサイクルの考え方から整理していこうか。」

1. Springの@PostConstructと@PreDestroyとは何か（基本的な役割）

Springの@PostConstructと@PreDestroyは、Beanのライフサイクルの特定のタイミングで処理を実行するためのアノテーションです。 Spring Bootでは、多くのオブジェクトがBeanとして管理されており、それぞれに「作られるタイミング」と「使われなくなるタイミング」が存在します。

@PostConstructは、Beanが生成され、必要な依存関係の注入が終わった直後に呼ばれます。一方、@PreDestroyは、アプリケーションの終了時などに、Beanが破棄される直前に呼ばれます。つまり、この二つは「最初」と「最後」に実行される処理を書くための仕組みです。

Spring Boot初心者の段階では、「@PostConstructは初期化用」「@PreDestroyは後片付け用」と覚えておくと理解しやすくなります。難しい内部構造を知らなくても、役割だけ把握しておけば十分です。


@Controller
public class SampleController {

    @PostConstruct
    public void init() {
        System.out.println("初期化処理が実行されました");
    }

    @PreDestroy
    public void destroy() {
        System.out.println("終了処理が実行されました");
    }

}

このようにメソッドにアノテーションを付けるだけで、 Spring Bootが自動的に適切なタイミングで処理を呼び出してくれます。開発者が自分で呼び出す必要はありません。

2. Beanライフサイクルとは何か（全体の流れをイメージで説明）

Beanライフサイクルとは、 Beanが作られてから破棄されるまでの一連の流れを指します。 Spring Bootでは、この流れをSpringフレームワークが一括で管理しています。

全体の流れを簡単にイメージすると、「Beanを作る → 初期化する → アプリの中で使う → 終了時に片付ける」という順番になります。 @PostConstructと@PreDestroyは、この中の「初期化」と「片付け」に関わっています。

開発者が普段意識しているのは、コントローラやサービスの処理部分だけかもしれません。しかし、裏側ではSpring BootがBeanを管理し、必要なタイミングで処理を呼び分けています。ライフサイクルを知ることで、なぜこのタイミングで処理が動くのかが見えてきます。

特に初心者のうちは、「Beanはずっと存在しているわけではない」という点を理解することが重要です。アプリ起動時に準備され、終了時にきちんと後片付けされる。その流れを支えているのがBeanライフサイクルです。


@Controller
public class LifeCycleController {

    @PostConstruct
    public void setup() {
        System.out.println("Beanが使える状態になりました");
    }
}

この例では、Beanが完全に準備できたタイミングで、初期化メッセージが出力されます。処理の流れを頭の中でイメージしながら読むと、ライフサイクルの理解が深まります。

3. Spring Boot初心者が混乱しやすいポイント

Spring Boot初心者が@PostConstructや@PreDestroyで混乱しやすい理由の一つは、「自分で呼び出していないのに処理が動く」点です。普通のJavaプログラムでは、メソッドは自分で呼ばなければ実行されません。

しかしSpring Bootでは、 Beanとして管理されているクラスについては、 Springが代わりにライフサイクルを制御します。そのため、アノテーションを付けるだけで、決まったタイミングで処理が実行されます。

また、@PostConstructが「コンストラクタの直後に必ず動く」と誤解されることもあります。正しくは、「依存関係の注入がすべて終わった後」に呼ばれます。この違いを知らないと、値が入っていない原因が分からず悩むことになります。

Spring Boot初心者の段階では、「ライフサイクルはSpringが管理している」「自分はタイミングだけ指定する」という考え方を持つと混乱しにくくなります。まずは役割と流れを押さえることが大切です。

4. @PostConstructで何が起きているのか（初期化処理のタイミング）

@PostConstructは、Beanライフサイクルの中でも 「Beanが使える状態になった直後」 に実行される処理です。 Spring BootがBeanを生成し、 @Valueや他のBeanの注入など、必要な準備がすべて終わった後に呼び出されます。

初心者がイメージしやすいように例えると、 @PostConstructは「部屋に家具を全部配置し終わってから行う最終チェック」のようなものです。まだ準備が終わっていない段階では実行されません。

そのため、@PostConstructの中では、他のBeanや設定値がすでに使える状態になっています。初期データの読み込みや、起動時に一度だけ行いたい処理を書くのに向いています。


@Controller
public class InitController {

    @PostConstruct
    public void init() {
        System.out.println("アプリ起動時の初期化処理");
    }

}

この処理は、アプリケーション起動時に一度だけ実行されます。リクエストのたびに動くわけではない点が、 Spring Boot初心者が特に混乱しやすいポイントです。

5. @PreDestroyで何が起きているのか（終了処理のタイミング）

@PreDestroyは、Beanライフサイクルの最後にあたる 「Beanが破棄される直前」 に実行される処理です。アプリケーションが終了するときに、 Spring Bootが自動的に呼び出します。

このタイミングは、サーバー停止やアプリケーションのシャットダウン時です。そのため、通常の画面操作やリクエスト処理の中では実行されません。

@PreDestroyは、ファイルや外部リソースの解放、ログの出力、後片付け処理を書くために使われます。「最後に一度だけやっておきたい処理」を書く場所だと考えると分かりやすくなります。


@Controller
public class DestroyController {

    @PreDestroy
    public void close() {
        System.out.println("アプリ終了時の後片付け処理");
    }

}

Spring Boot初心者のうちは、「@PreDestroyは普段は目に見えにくい」という点で不安になることがあります。しかし、アプリが正しく終了するために、裏側で確実に実行されている処理だと理解しておくと安心です。

6. Beanの生成から破棄までの流れを図解イメージで解説

ここまでの内容を踏まえて、 Beanライフサイクル全体の流れを言葉による図解イメージで整理してみましょう。

Spring Bootアプリケーションが起動すると、まずSpringがクラスを読み込み、 @Controllerなどが付いたクラスをBeanとして生成します。この段階では、まだ準備途中の状態です。

次に、設定値の読み込みや、他のBeanの注入が行われます。すべての準備が整ったタイミングで、 @PostConstructが実行され、 Beanは「使える状態」になります。

その後、アプリケーションが動作している間、 Beanはリクエスト処理などで繰り返し利用されます。開発者が普段書いている処理は、この「使われる」期間のものです。

そしてアプリケーション終了時、 Spring BootはBeanを破棄する準備に入ります。その直前に@PreDestroyが呼び出され、後片付け処理が行われます。これでBeanライフサイクルは完了です。


@Controller
public class FlowController {

    @PostConstruct
    public void start() {
        System.out.println("生成と初期化の完了");
    }

    @PreDestroy
    public void end() {
        System.out.println("破棄前の処理");
    }

}

「作られる → 初期化される → 使われる → 破棄される」という流れを頭の中で描けるようになると、 @PostConstructと@PreDestroyの役割が自然と結び付いて理解できるようになります。まずはこの全体像をしっかり押さえることが大切です。

7. @PostConstruct / @PreDestroyを使うメリット

@PostConstructと@PreDestroyを使う最大のメリットは、 Beanの「始まり」と「終わり」をはっきり分けて管理できる 点にあります。 Spring Boot初心者のうちは、処理をどこに書けばよいのか迷いがちですが、ライフサイクルに沿って役割を分けることで、コードの意図が分かりやすくなります。

たとえば、起動時に一度だけ行いたい処理を通常のメソッドに書いてしまうと、いつ実行されるのかがコードから読み取りにくくなります。 @PostConstructを使えば、「これは初期化処理だ」と一目で分かるようになります。

同様に、@PreDestroyを使うことで、アプリケーション終了時の後片付け処理を明確に分離できます。 Bean管理をSpringに任せているからこそ、「最後に必ず実行される場所」を用意できるのが大きな強みです。


@Controller
public class MeritController {

    @PostConstruct
    public void prepare() {
        System.out.println("起動時の準備処理");
    }

    @PreDestroy
    public void cleanup() {
        System.out.println("終了時の後片付け処理");
    }

}

Spring Boot初心者にとっては、「処理の置き場所が決まっている」というだけでも安心材料になります。 Beanライフサイクルを意識したコードは、実務でも読みやすく、保守しやすい構造になります。

8. よくあるミスと処理が呼ばれない原因

@PostConstructや@PreDestroyが「動かない」と感じるとき、ほとんどの場合は初歩的な原因があります。 Spring Boot初心者が最初につまずきやすいポイントを、ここで整理しておきましょう。

まず多いのが、 そのクラスがBeanとして管理されていない ケースです。 @Controllerなどが付いていないクラスでは、 Springがライフサイクルを管理しないため、アノテーションを書いても処理は呼ばれません。

次によくあるのが、メソッドの定義ミスです。 @PostConstructや@PreDestroyが付いたメソッドは、引数を持たず、戻り値もvoidである必要があります。条件を満たしていないと、処理が実行されない原因になります。

また、@PreDestroyについては、アプリケーションが正常に終了していない場合、呼ばれないことがあります。強制終了や異常停止では、後片付け処理が実行されない点も、初心者が混乱しやすいポイントです。


@Controller
public class MissController {

    @PostConstruct
    public void initProcess() {
        System.out.println("正しく定義された初期化処理");
    }

}

「動かない」と感じたときは、まず「このクラスは本当にBeanか」「定義方法は正しいか」を確認する癖を付けると、トラブルを早く解決できるようになります。

9. 実務での利用イメージと学習時の考え方

実務でSpring Bootを使う場合、 @PostConstructや@PreDestroyは、毎日のように目にするものではありません。しかし、「必要な場面では確実に使われる」重要な仕組みです。

たとえば、起動時に設定ファイルを読み込んでチェックしたり、外部サービスとの接続準備をしたりする処理は、 @PostConstructにまとめられることが多いです。これにより、起動時の流れが整理され、トラブル時の原因追跡もしやすくなります。

一方で、 @PreDestroyは、ログの出力やリソース解放など、「最後に必ずやっておきたいこと」を書く場所として使われます。普段は意識しなくても、アプリの安定性を支えている存在です。


@Controller
public class PracticalController {

    @PostConstruct
    public void startup() {
        System.out.println("実務を想定した起動処理");
    }

    @PreDestroy
    public void shutdown() {
        System.out.println("実務を想定した終了処理");
    }

}

学習段階では、「完璧に使いこなそう」と考える必要はありません。まずは、 Beanライフサイクルの中で「ここで動く処理がある」とイメージできるようになることが大切です。

Spring Boot初心者のうちは、 @PostConstructと@PreDestroyを「後から効いてくる知識」として頭の片隅に置いておきましょう。学習が進むにつれて、 Bean管理やライフサイクルの理解が深まり、自然と必要性が実感できるようになります。