起動を速くしたくて spring.main.lazy-initialization=true を入れたら、本番の初回リクエストで初めてエラーが出た。そんな経験はないでしょうか。そもそも @Lazy を付けると何が遅れるのか、グローバル設定とどう使い分けるのか、意外と曖昧ですよね。
この記事では、コンストラクタにログを仕込んでBeanの生成タイミングを確かめながら、@Lazy の付け方ごとの違い、グローバル設定と除外の方法、本番で困る落とし穴を整理します。前提はSpring Boot 3.5系、Java 21です。コード中の @Slf4j はLombokのアノテーションなので、Lombokを使っていなければ LoggerFactory.getLogger に読み替えてください。Spring Boot 4.xでもプロパティや除外フィルタの考え方は同じですが、自動構成まわりは配置が変わっているので、細かい挙動はお使いのバージョンで確かめましょう。
なお、JPAの FetchType.LAZY はエンティティの関連を遅延ロードする別の仕組みです。そちらは LazyInitializationExceptionの記事 で扱っています。
遅延初期化とは何か
Spring Bootのsingleton Beanは、デフォルトでは起動時(ApplicationContextのrefresh時)にまとめて生成されます。遅延初期化を有効にすると、getBean されたときや他のBeanに注入されるときまで生成が後回しになります。
確かめるには、コンストラクタにログを入れるのがいちばん手っ取り早いです。
@Slf4j
@Component
public class ReportService {
public ReportService() {
log.info("ReportService created");
}
}
普通に起動すると、このログは Started DemoApplication in ... seconds より前に出ます。遅延されていれば、Startedの後、実際に使われたタイミングで出ます。@PostConstruct も生成と一緒に後ろへずれます。全体の流れは Beanライフサイクルの記事 にまとめています。
@Lazyは付ける場所で効き方が変わる
まずはグローバル設定をオフのまま、@Lazy だけを試します。付けられる場所は大きく4つです。
クラスと@Beanメソッドに付ける
基本はクラスに付ける形です。@Service や @Repository でも同じように動きます(@Component 自体は @Componentの解説記事 をどうぞ)。
@Lazy
@Service
public class ReportService { /* ... */ }
外部APIクライアントのように @Bean で定義するものは、メソッドに付ければそのBeanだけが遅延されます。
@Configuration
public class ClientConfig {
@Bean
@Lazy
public HeavyApiClient heavyApiClient() {
return new HeavyApiClient(); // 初期化が重い想定
}
}
@Configurationクラスに付ける
@Configuration に付けると、配下の @Bean がすべて遅延対象になります。一部だけ起動時に作りたいなら @Lazy(false) で上書きできます。
@Lazy
@Configuration
public class ReportConfig {
@Bean
public PdfRenderer pdfRenderer() { return new PdfRenderer(); } // 遅延される
@Bean
@Lazy(false)
public TemplateLoader templateLoader() { return new TemplateLoader(); } // 起動時に生成
}
注入ポイントに付ける
注入する側の引数やフィールドに付けると、実体ではなくプロキシが注入されます。ここでは ReportService 自体にもクラスの @Lazy が付いている前提です。
@Slf4j
@Service
public class OrderService {
private final ReportService reportService; // ReportServiceはクラスに@Lazyあり
public OrderService(@Lazy ReportService reportService) {
this.reportService = reportService;
log.info("injected: {}", reportService.getClass().getSimpleName());
}
public void finish() {
reportService.generate(); // ここで初めて ReportService created が出る
}
}
起動ログには injected: ReportService$$SpringCGLIB$$0 のようにプロキシのクラス名が出ます(Spring Framework 6.xでの命名です)。finalクラスやアクセスできるコンストラクタのないクラスはCGLIBでプロキシにできないので注意しましょう。
大事なのは、注入ポイントの @Lazy が遅らせるのは依存の解決だけという点です。ReportService が普通のsingletonなら起動時に生成済みで、プロキシはその実体へ委譲するだけになります。注入方式そのものの違いは 依存性注入3方式の比較 を参照してください。
| 付ける場所 | 遅延される対象 | 実体が作られるタイミング |
|---|---|---|
| クラス・@Beanメソッド | そのBean | 最初に要求・注入されたとき |
| @Configuration | 配下の@Beanすべて | 最初に要求・注入されたとき |
| 注入ポイント | 依存の解決(対象Bean自体がlazyな場合のみ生成も遅延) | メソッドを初めて呼んだとき |
@Lazyを付けたのに起動時に生成される
ハマりやすいのがこれです。ReportService に @Lazy を付けても、遅延されていない OrderService がコンストラクタで普通に受け取ると、OrderService を作る時点で ReportService も作られてしまいます。ログを見ると「@Lazyなのに起動時にcreatedが出る」状態ですね。
直すには、注入する側にも @Lazy を付ける(前節の形)か、ObjectProvider で必要なときに取り出します。
@Service
public class OrderService {
private final ObjectProvider<ReportService> reportService;
public OrderService(ObjectProvider<ReportService> reportService) {
this.reportService = reportService;
}
public void finish() {
reportService.getObject().generate();
}
}
@Scope(proxyMode = ...) もプロキシを使いますが、こちらはスコープのための別の仕組みです。気になる方は Beanスコープの記事 をどうぞ。
spring.main.lazy-initializationでアプリ全体を遅延させる
Spring Boot 2.2以降は、プロパティ1行でアプリ内の全Bean定義を遅延対象にできます。
spring.main.lazy-initialization=true
コードから設定するなら次のどちらかです。
// SpringApplicationBuilderを使う場合
new SpringApplicationBuilder(DemoApplication.class)
.lazyInitialization(true)
.run(args);
// SpringApplicationを直接使う場合
SpringApplication app = new SpringApplication(DemoApplication.class);
app.setLazyInitialization(true);
app.run(args);
ローカル開発だけで効かせたいなら、application-dev.properties に書いてdevプロファイルで起動するのが扱いやすいです。プロファイルの切り替え方は プロファイルの記事 を参照してください。
個別の @Lazy は「遅らせたいものを選ぶ」、グローバル設定は「全部遅らせて、外したいものを選ぶ」という発想の違いだと考えると整理しやすいですよ。
一部のBeanを遅延対象から外す
グローバル設定を使うときの除外方法は2つあります。自分のクラスなら @Lazy(false) を付けるだけです。
ライブラリが登録するBeanのように注釈を付けられないものは、LazyInitializationExcludeFilter をBeanとして登録して型で指定します(Spring Boot 2.2以降)。
@Configuration
public class LazyExcludeConfig {
@Bean
static LazyInitializationExcludeFilter eagerBeans() {
// 生成時に認証情報を検証するSDKクライアントを想定
return LazyInitializationExcludeFilter.forBeanTypes(PaymentGatewayClient.class);
}
}
コンストラクタで接続や設定を検証するクライアントを除外しておけば、そのミスは起動時に見つかります。逆に DataSource を除外しても、HikariCPは最初の getConnection までプールを開始しないので、接続設定のミスは起動時には出ません。ここは勘違いしやすいところです。
起動時間の測り方
効果を確かめるには、コンストラクタで意図的に待機する計測用のBeanを用意するとわかりやすいです。
@Component
public class SlowStartupBean {
public SlowStartupBean() throws InterruptedException {
Thread.sleep(2000); // 重い初期化の代わり
}
public String hello() { return "hello"; }
}
有効・無効をそれぞれ5回ほど起動し、ログの Started DemoApplication in X seconds の値を平均します。あわせて、このBeanを使うエンドポイントへの初回リクエストの時間も測りましょう。
java -jar target/demo.jar --spring.main.lazy-initialization=true
# 別ターミナルで初回リクエストの所要時間を測る
curl -o /dev/null -s -w "%{time_total}\n" http://localhost:8080/hello
理屈では、Startedの値は待機時間の分だけ縮み、その分が初回リクエストへ移ります。短縮されるのは自作Beanや重いBeanの生成時間で、自動構成の評価やクラスロード、組み込みTomcatの起動は残ります。実際の差はマシンや構成で大きく変わるので、この記事では数値を一般化せず、自分のアプリで測ることをおすすめします。CDSやAOTなど他の手段は 起動高速化の記事 で扱っています。
遅延初期化で起きる落とし穴
設定ミスが初回アクセスまで見つからない
@Value("${payment.api-key}") のプロパティが足りなくても起動は成功し、そのBeanを初めて使うリクエストで BeanCreationException になります。設定値を起動時に検証したいなら @ConfigurationPropertiesのバリデーション記事 の方法が使えます。依存Beanが欠けている場合も同じで、原因の探し方は NoSuchBeanDefinitionExceptionの解決記事 が参考になります。ヘルスチェックが触らないBeanなら、デプロイ直後の確認も素通りです。
対策としては、CIで遅延初期化を切ったコンテキスト起動テストを1本持っておくのが効きます。
@SpringBootTest(properties = "spring.main.lazy-initialization=false")
class EagerContextLoadTest {
@Test
void contextLoads() {
}
}
起動エラーの読み方は 起動しない時の切り分け記事 をどうぞ。
初回リクエストが遅くなる
初回リクエストでController、Service、Repositoryと連なるBeanがまとめて生成されるため、レイテンシが増えます。JITのウォームアップによる遅さとは別の問題で、両方が重なることもあります。
ちなみに DispatcherServlet の初期化は、遅延初期化の設定とは関係なくデフォルトで初回リクエスト時に行われます(spring.mvc.servlet.load-on-startup=-1)。グローバル遅延を入れると、そこに業務Beanの生成が上乗せされるイメージです。readinessを返す前にウォームアップリクエストを流すか、重要な経路のBeanを除外しておきましょう。
起動時処理を書いたBeanが動かない
どこからも注入されないBeanは、グローバル遅延の下では一度も生成されません。@PostConstruct でキャッシュを温めるようなBeanは、黙って何もしないことになります。
@Lazy(false)
@Component
public class CacheWarmer {
@PostConstruct
void warmUp() { /* キャッシュ読み込み */ }
}
ApplicationRunner や CommandLineRunner のBeanは、遅延初期化を有効にしても起動時に取り出されて実行されます。起動時の処理はこちらに書くのも手です。
@Scheduled は、@EnableScheduling が付いていれば、Spring Boot 2.4以降の自動構成が ScheduledBeanLazyInitializationExcludeFilter を登録し、@Scheduled メソッドを持つBeanを遅延対象から外します。そのため3.5系ではグローバル遅延を有効にしてもスケジュールは動きます。自動構成が効かない構成なら @Lazy(false) を付けておきましょう。@EventListener はイベント発生時にBeanが生成されるので動きますが、生成タイミングはずれます。@Scheduled の基本は @Scheduledの記事 をどうぞ。
ヒープサイズの見積もりがずれる
公式ドキュメントでも注意されているのがこれです。起動直後は全Beanが揃っていないので、メモリ使用量が少なく見えます。本番で使うなら、全Beanが生成された状態を前提にヒープサイズを決めるよう勧められています。
補足:循環参照と@Lazy
コンストラクタインジェクションで循環参照が起きたとき、片方の注入ポイントに @Lazy を付けるとプロキシで循環を断ち切れます。ただしこれは一時しのぎで、責務を分けるなど設計を見直すのが本筋です。
まとめ
遅延初期化は起動時の仕事を後ろへ回すだけで、仕事そのものが減るわけではありません。どこに回すと困らないかで判断しましょう。
| 場面 | おすすめ |
|---|---|
| ローカル開発 | devプロファイルで有効にしてよい |
| テスト | 速さ重視なら有効、ただしeager起動テストを1本残す |
| 本番 | 原則無効。使うなら重いBeanに個別の@Lazy |
| CLIやサーバーレスで使わないBeanが多い | 有効化を検討する価値あり |
有効にするなら、起動時処理や生成時に検証するBeanの除外、CIでのeager起動テスト、ヒープサイズの見積もりの3点だけは押さえておくと安心です。