Spring Bootの初期テスト導入を完全ガイド！JUnit 5とSpring Boot Testの基本を初心者向けに解説

1. JUnit 5とは？Spring Bootとの関係

1. JUnit 5とは？Spring Bootとの関係

JUnit（ジェイユニット）は、Javaの代表的なテストフレームワークです。Spring BootではJUnit 5を使うことで、シンプルに単体テストや統合テストを記述できます。

Spring Bootの依存にspring-boot-starter-testを追加すれば、JUnit 5がすぐに使える状態になります。この中には、JUnit 5だけでなく、MockitoやAssertJなどの便利なテストライブラリも含まれています。

dependencies {
    testImplementation 'org.springframework.boot:spring-boot-starter-test'
}

この設定を行うだけで、JUnit 5でのテスト環境が整います。

2. JUnit 5の基本的なテストの書き方

2. JUnit 5の基本的なテストの書き方

JUnit 5では、@Testアノテーションを使ってテストメソッドを定義します。例えば、簡単な足し算の処理をテストするには以下のように書きます。

import org.junit.jupiter.api.Test;
import static org.junit.jupiter.api.Assertions.assertEquals;

public class CalculatorTest {

    @Test
    void testAddition() {
        int result = 2 + 3;
        assertEquals(5, result);
    }
}

このようにJUnit 5では、シンプルな記述で動作確認ができるため、初心者にもおすすめです。

3. Spring Boot Testとは何か？

3. Spring Boot Testとは何か？

Spring Boot Test（スプリング・ブート・テスト）は、Springアプリケーションを起動した状態でテストするための仕組みです。

@SpringBootTestアノテーションを使うことで、アプリ全体を起動し、SpringのDIコンテナを利用しながらテストを実行できます。これにより、コントローラやサービスなどの統合テストが可能になります。

@SpringBootTest
class MyServiceTest {

    @Autowired
    private MyService myService;

    @Test
    void testServiceLogic() {
        String result = myService.process("input");
        assertEquals("expected", result);
    }
}

@Autowiredを使ってテスト対象のクラスを注入し、Springの機能を活かしたテストができるのがSpring Boot Testの特徴です。

4. コントローラのテストには@WebMvcTest

4. コントローラのテストには@WebMvcTest

Webアプリケーションでは、コントローラのテストも重要です。その際によく使われるのが@WebMvcTestです。

このアノテーションを使うと、MVC関連のコンポーネントだけをテスト対象にできるため、起動が高速で、ピンポイントな検証が可能になります。

@WebMvcTest(MyController.class)
class MyControllerTest {

    @Autowired
    private MockMvc mockMvc;

    @Test
    void testHelloEndpoint() throws Exception {
        mockMvc.perform(get("/hello"))
               .andExpect(status().isOk())
               .andExpect(content().string("Hello World"));
    }
}

MockMvcを使うことで、HTTPリクエストをシミュレートし、コントローラの挙動をしっかり確認できます。

5. Mockitoを使った依存のモック

5. Mockitoを使った依存のモック

テストの中で、他のクラスに依存している場合、そのクラスの代わりにMockitoでモック（偽物）を作ることができます。

これにより、テストしたい部分だけに集中した検証ができます。

@ExtendWith(MockitoExtension.class)
class MyServiceTest {

    @Mock
    private MyRepository myRepository;

    @InjectMocks
    private MyService myService;

    @Test
    void testLogicWithMock() {
        when(myRepository.findData()).thenReturn("mocked");

        String result = myService.process();
        assertEquals("mocked result", result);
    }
}

Mockitoを使えば、外部依存に影響されないユニットテストが書けるようになります。

6. Spring Bootのテストでよくあるエラーと対処法

6. Spring Bootのテストでよくあるエラーと対処法

依存関係が注入されない → @Autowiredが付いていない、またはテストクラスに@SpringBootTestが付いていない場合に発生します。

MockMvcがnullになる → @WebMvcTestとMockMvcの組み合わせを確認しましょう。

アプリ全体が起動して重い → 単体テストでは@SpringBootTestではなく@MockBeanなどを活用して部分的にテストを行いましょう。

まとめ

まとめ

Spring Bootにおけるテスト導入は、JUnit 5とSpring Boot Testを中心に理解することで一気に実践しやすくなります。とくに初心者は「テストの種類」「アノテーションの使い分け」「DIを利用したテストの考え方」で混乱しやすいため、今回の記事のように段階的に学ぶ方法が非常に効果的です。JUnit 5の基本構文を押さえておけば、単体テストで小さな処理を検証する自信がつき、さらにSpring Boot Testを使うことでアプリ全体を動かしながらの統合テストへスムーズに進めます。こうした学習の積み重ねは、品質の高いアプリケーションを構築するうえで欠かせない基礎となります。 Spring Boot Testの魅力は、DIコンテナをそのまま利用できるため、実際のアプリケーションに近い環境で動作確認ができる点にあります。同時に、@WebMvcTestで軽量なコントローラテストを行ったり、Mockitoで依存のモックを作成したりと、目的に応じてテスト手法を切り替える柔軟性があることも大きな利点です。たとえば、コントローラの挙動確認だけを行うならアプリ全体の起動は不要であり、MockMvcのような仕組みを使えば効率的な検証ができます。 また、実際のテスト現場では「依存が注入されない」「MockMvcがnullになる」といった初歩的なエラーが起こりやすいため、アノテーションの付け方やテスト種類の選択を正しく行うことが重要です。記事で紹介したように、単体テスト・統合テスト・コントローラテストなどの違いを明確に理解しておくことで、どの場面でどのアノテーションを使うべきか判断できるようになります。 さらに、テストを書くことは単にエラーを見つけるためだけではなく、アプリケーションの仕様を自分自身で整理し、動作の根拠を明確にする役割も持っています。コードの変更による影響範囲も確認しやすくなり、結果として開発効率と品質の向上につながります。JUnit 5とSpring Boot Testの使い分けを身につけることで、テストが難しいものではなく、むしろ開発を支える強力な味方だと感じられるはずです。 以下に、今回理解した内容を実践に近い形でまとめたサンプルコードを掲載します。Spring Boot TestとMockitoを組み合わせたよくあるテスト例です。

サンプルプログラム：Spring Boot Test + Mockitoの組み合わせ

@SpringBootTest
class SummaryServiceTest {

    @MockBean
    private UserRepository userRepository;

    @Autowired
    private SummaryService summaryService;

    @Test
    void testSummaryOutput() {
        when(userRepository.findName()).thenReturn("山田");

        String result = summaryService.createMessage();
        assertEquals("こんにちは山田さん", result);
    }
}

この例では、Spring Boot Testによってアプリケーション全体を起動しつつ、Mockitoの@MockBeanで依存をモック化しています。実際の開発でも頻繁に利用される構成で、サービス層の動きだけを正確に検証できます。JUnit 5の@Testを使った単体テストの基礎に加え、Spring Boot Testの強みであるDIと統合的なテスト環境の両方を体験できる形になっており、初心者にとって非常に有効な学習ステップとなるでしょう。 テスト設計の幅が広がることで、開発全体の見通しも改善されます。重要なのは、目的に応じて必要なテストを選び、過不足ない形で実装できる判断力を身につけることです。JUnit 5の書き方、Spring Boot Testのアノテーション、コントローラ向けの@WebMvcTest、外部依存を切り離すMockitoなど、今回学んだポイントを組み合わせることで、あらゆるテストパターンに対応できる柔軟なテスト設計が可能になります。 それでは、学んだ内容をもう一度整理するために、先生と生徒の振り返り会話を見ていきましょう。