<h2 id="%E3%81%A9%E3%82%93%E3%81%AA%E4%BA%BA%E5%90%91%E3%81%91%3F">
<a class="header-anchor-link" href="#%E3%81%A9%E3%82%93%E3%81%AA%E4%BA%BA%E5%90%91%E3%81%91%3F" aria-hidden="true"></a> どんな人向け?</h2>
<ul>
<li>Spring Boot 2系でSpring Batchを使用したプロジェクトを持っていて、Spring Boot 3にアップデートする人。</li>
</ul>
<h2 id="%E3%81%93%E3%81%AE%E8%A8%98%E4%BA%8B%E3%81%8C%E6%89%B1%E3%81%86%E5%95%8F%E9%A1%8C%E3%81%AF%3F">
<a class="header-anchor-link" href="#%E3%81%93%E3%81%AE%E8%A8%98%E4%BA%8B%E3%81%8C%E6%89%B1%E3%81%86%E5%95%8F%E9%A1%8C%E3%81%AF%3F" aria-hidden="true"></a> この記事が扱う問題は?</h2>
<ul>
<li>Spring Boot 3にアップデートしたら、Spring Batchのジョブが起動しなくなった。</li>
<li>Spring Boot 3にアップデートしたら、バッチのメタデータ用<code>DataSource</code>に<code>@BatchDataSource</code>を指定していたのに突然メインの<code>DataSource</code>を使いだした。</li>
</ul>
<h2 id="%E7%B5%90%E8%AB%96">
<a class="header-anchor-link" href="#%E7%B5%90%E8%AB%96" aria-hidden="true"></a> 結論</h2>
<p><code>@EnableBatchProcessing</code>を付与した場合の挙動が変わったためです。</p>
<ul>
<li>Spring Boot 2系 × Spring Batch 4系: Spring Batchの機能を有効化する</li>
<li>Spring Boot 3系 × Spring Batch 5系: Spring Batchの機能をカスタマイズできるようにする</li>
</ul>
<p>特にBatchの機能をカスタマイズして使っているわけではない場合、<code>@EnableBatchProcessing</code>を外してみてください。</p>
<h2 id="%E8%A7%A3%E8%AA%AC">
<a class="header-anchor-link" href="#%E8%A7%A3%E8%AA%AC" aria-hidden="true"></a> 解説</h2>
<p>Spring BootでSpring Batchを使用する場合、関連するBeanはSpring Bootの<a href="https://github.com/spring-projects/spring-boot/blob/main/spring-boot-project/spring-boot-autoconfigure/src/main/java/org/springframework/boot/autoconfigure/batch/BatchAutoConfiguration.java" target="_blank" rel="nofollow noopener noreferrer"><code>org.springframework.boot.autoconfigure.batch.BatchAutoConfiguration</code></a>で自動構成されます。</p>
<ol>
<li>Spring Batch 4 → 5へのアップデートでは、設定クラスに破壊的変更がありました。
<ul>
<li><a href="https://docs.spring.io/spring-batch/docs/5.0.0/reference/html/whatsnew.html#new-configuration-class" target="_blank" rel="nofollow noopener noreferrer">https://docs.spring.io/spring-batch/docs/5.0.0/reference/html/whatsnew.html#new-configuration-class</a></li>
<li><a href="https://github.com/spring-projects/spring-batch/blob/main/spring-batch-core/src/main/java/org/springframework/batch/core/configuration/support/DefaultBatchConfiguration.java" target="_blank" rel="nofollow noopener noreferrer"><code>org.springframework.batch.core.configuration.support.DefaultBatchConfiguration.DefaultBatchConfiguration</code></a></li>
</ul>
</li>
<li>Spring Boot 3はこれに追従し、Spring Batchの<code>DefaultBatchConfiguration</code>をベースとしてカスタマイズする方式に変更しました。
<ul>
<li><a href="https://github.com/spring-projects/spring-boot/commit/64f4da80cb65e39214910cea93de03584922177d" target="_blank" rel="nofollow noopener noreferrer">https://github.com/spring-projects/spring-boot/commit/64f4da80cb65e39214910cea93de03584922177d</a></li>
<li><a href="https://github.com/spring-projects/spring-boot/blob/main/spring-boot-project/spring-boot-autoconfigure/src/main/java/org/springframework/boot/autoconfigure/batch/BatchAutoConfiguration.java" target="_blank" rel="nofollow noopener noreferrer"><code>org.springframework.boot.autoconfigure.batch.BatchAutoConfiguration</code></a></li>
</ul>
</li>
<li>Spring Bootの<a href="https://github.com/spring-projects/spring-boot/blob/main/spring-boot-project/spring-boot-autoconfigure/src/main/java/org/springframework/boot/autoconfigure/batch/BatchAutoConfiguration.java" target="_blank" rel="nofollow noopener noreferrer"><code>org.springframework.boot.autoconfigure.batch.BatchAutoConfiguration</code></a>は<code>@EnableBatchProcessing</code>が付与されたBeanが存在すると有効にならず、Spring Batch関連Beanがカスタマイズ可能な状態になります。</li>
</ol>
<p>アプリケーションに<code>@EnableBatchProcessing</code>を付与したままSpring Boot 3系 × Spring Batch 5系にアップデートしてしまうと、意図せずカスタマイズ可能な状態となってしまい、</p>
<ul>
<li>ジョブが起動しない</li>
<li>
<code>@BatchDataSource DataSource</code>が使われない</li>
</ul>
<p>という状態になってしまいます。</p>
<h2 id="%E8%A3%9C%E8%B6%B3">
<a class="header-anchor-link" href="#%E8%A3%9C%E8%B6%B3" aria-hidden="true"></a> 補足</h2>
<p>Spring Batch 5系では、解説内に記載した設定クラスの変更に加えて、メタデータスキーマの更新など破壊的変更が多くあります。<br>
マイグレーションガイドが提供されていますので、アップデート対応を行う際は参考にされることをおすすめします。</p>
<ul>
<li><a href="https://github.com/spring-projects/spring-batch/wiki/Spring-Batch-5.0-Migration-Guide" target="_blank" rel="nofollow noopener noreferrer">Spring Batch 5.0 Migration Guide</a></li>
</ul>
<h2 id="%E5%8F%82%E8%80%83">
<a class="header-anchor-link" href="#%E5%8F%82%E8%80%83" aria-hidden="true"></a> 参考</h2>
<ul>
<li><a href="https://github.com/spring-projects/spring-boot/blob/main/spring-boot-project/spring-boot-autoconfigure/src/main/java/org/springframework/boot/autoconfigure/batch/BatchAutoConfiguration.java" target="_blank" rel="nofollow noopener noreferrer"><code>org.springframework.boot.autoconfigure.batch.BatchAutoConfiguration</code></a></li>
<li><a href="https://github.com/spring-projects/spring-batch/blob/main/spring-batch-core/src/main/java/org/springframework/batch/core/configuration/support/DefaultBatchConfiguration.java" target="_blank" rel="nofollow noopener noreferrer"><code>org.springframework.batch.core.configuration.support.DefaultBatchConfiguration.DefaultBatchConfiguration</code></a></li>
<li><a href="https://docs.spring.io/spring-batch/docs/5.0.0/reference/html/whatsnew.html#whatsNew" target="_blank" rel="nofollow noopener noreferrer">Spring Batch - Reference Documentation What’s New in Spring Batch 5.0</a></li>
<li><a href="https://github.com/spring-projects/spring-batch/wiki/Spring-Batch-5.0-Migration-Guide" target="_blank" rel="nofollow noopener noreferrer">Spring Batch 5.0 Migration Guide</a></li>
</ul>


Spring Boot 3にアップデートしたらSpring Batchが動かなくなった

Discussion