こんにちは！日々のJava開発、本当にお疲れ様です。
大きなプロダクトになってくると、避けて通れないのが「テスト実行の待ち時間問題」ですよね。
「ちょっとコードを直してビルドしただけなのに、テストが完了するまでに数分かかる……」「CI/CDパイプラインでテストが終わるのをコーヒーを飲みながら待つ時間がもったいない……」
そんなストレスを抱えたことはありませんか？
今回は、世界最高峰のビルド・パッケージ管理ツールである Gradle と、モダンなテストフレームワーク JUnit 5 を組み合わせて、テスト実行を劇的に爆速化する実践テクニックを伝授します。
これをマスターすれば、毎日のコーディングと検証サイクルが劇的に軽快になり、開発体験（DX）が跳ね上がりますよ。さあ、一緒にその裏側のメカニズムと具体的な設定方法を見ていきましょう！
—
なぜテストは遅くなるのか？（ビルドツールの内部と並列実行の思想）
まず、なぜテストが遅くなるのか、その本質を理解しましょう。
デフォルトの状態では、JUnitのテストは「シングルスレッド（1つの処理の流れ）」で順番に実行されます。つまり、CPUのコアがいくら余っていても、1つのテストクラスが終わるまで次のテストクラスは待たされる状態になっています。
これを解決するのが JUnit 5の並列実行（Parallel Execution） です。
CPUのマルチコアをフルに活用し、複数のテストを同時に走らせることで、物理的な実行時間をコア数に比例して短縮できます。
さらに、プロジェクトが巨大化すると、「数秒で終わる単体テスト」と「数分かかる重い結合テスト（DB接続やコンテナ起動を伴うもの）」が混在してきます。これらを一緒くたに実行していることが、ビルド遅延の最大の原因です。
そのため、「テストの分割戦略（ライフサイクルの分離）」が極めて重要になります。
—
1. 最速の第一歩：Gradle × JUnit 5 並列実行のセットアップ
それでは、実際にプロジェクトへ並列実行を導入していきましょう。
今回は、現代のJava開発スタンダードである Gradle を使って解説します。
動作確認用プロジェクトの構成
まずは、次のようなシンプルなディレクトリ構成とファイルを用意してください。
my-fast-project/
├── build.gradle
└── src/
└── test/
└── java/
└── com/
└── example/
├── FastTestOne.java
└── FastTestTwo.java
ステップ1: `build.gradle` の設定
GradleでJUnit 5を有効にし、テストタスクに対して「並列実行を許可せよ」という指示を与えます。ここが最初の心臓部です。
// build.gradle
plugins {
id ‘java’
}
group = ‘com.example’
version = ‘1.0-0’
repositories {
// 依存関係をダウンロードするリポジトリを指定
mavenCentral()
}
dependencies {
// JUnit 5のAPIとエンジンをインポート
testImplementation ‘org.junit.jupiter:junit-jupiter:5.10.2’
testRuntimeOnly ‘org.junit.platform:junit-platform-launcher’
}
// テスト実行時の挙動を設定するブロック
test {
// Gradle標準のテストランナーにJUnit 5を使用することを明示
useJUnitPlatform()
// ターミナルにテストの実行結果を詳細に出力する設定
testLogging {
events “passed”, “skipped”, “failed”
showStandardStreams = true
}
// 【重要】Gradleレベルでも複数ワーカーでのテスト実行を許可する場合の設定
// マシン全体のCPUコア数を活用するためにプロセスを分散させます
maxParallelForks = (Runtime.getRuntime().availableProcessors() / 2).intdiv(1) ?: 1
systemProperty ‘junit.jupiter.execution.parallel.enabled’, ‘true’
}
ステップ2: JUnit 5の並列動作設定ファイルを作成
JUnit 5自体のエンジンに対して、「どのように並列で動かすか」を指示するため、テストのリソースディレクトリに設定ファイルを追加します。
配置場所: `src/test/resources/junit-platform.properties`
junit-platform.properties
JUnit 5のテスト並列実行を有効化する
junit.jupiter.execution.parallel.enabled = true
同時実行のモード設定
same_thread: 同じスレッド内で直列実行
concurrent : 異なるスレッドで並列実行（テストクラス単位の並列化）
junit.jupiter.execution.parallel.mode.default = concurrent
クラス内のテストメソッド単位まで並列化したい場合は下記を指定
junit.jupiter.execution.parallel.mode.classes.default = concurrent
—
2. 精度高い「HelloWorld的」動作確認
設定が正しく機能しているか、実際にテストコードを書いてコンソールでスレッド名を確認してみましょう。
テストコードの実装
`src/test/java/com/example/FastTestOne.java` と `FastTestTwo.java` を作成します。
// src/test/java/com/example/FastTestOne.java
package com.example;
import org.junit.jupiter.api.Test;
public class FastTestOne {
@Test
void testA() throws InterruptedException {
// 現在動いているスレッド名を出力し、並列実行されていることを目視する
System.out.println(“>>> Executing testA on thread: ” + Thread.currentThread().getName());
Thread.sleep(500); // 0.5秒待機（処理をシミュレート）
}
@Test
void testB() throws InterruptedException {
System.out.println(“>>> Executing testB on thread: ” + Thread.currentThread().getName());
Thread.sleep(500);
}
}
もう一つのテストクラスも同様に作成します。
// src/test/java/com/example/FastTestTwo.java
package com.example;
import org.junit.jupiter.api.Test;
public class FastTestTwo {
@Test
void testC() throws InterruptedException {
System.out.println(“>>> Executing testC on thread: ” + Thread.currentThread().getName());
Thread.sleep(500);
}
@Test
void testD() throws InterruptedException {
System.out.println(“>>> Executing testD on thread: ” + Thread.currentThread().getName());
Thread.sleep(500);
}
}
コマンド実行とログの確認
ターミナルを開き、以下のGradleコマンドを実行してテストを走らせます。
./gradlew test
実行結果のイメージ（出力ログ）:
> Task :test
>>> Executing testA on thread: Test worker @
>>> Executing testC on thread: Test worker @
>>> Executing testB on thread: Test worker @
>>> Executing testD on thread: Test worker @
BUILD SUCCESSFUL in 1s
お気づきでしょうか？
ログを見ると、`worker-1` と `worker-2` という複数の異なるスレッドが同時に立ち上がり、別々のテストを並行して処理していることが分かります。
シミュレートした待機時間が重複するため、全テストが直列の場合（2秒以上）に比べて、圧倒的に短い時間（約1秒）でビルドが完了します！
—
3. 実務の現場で効く！重い結合テストを別ライフサイクルへ切り離す戦略
並列実行だけでテストが増えてくると、今度は「DBやDockerコンテナを立ち上げるような重い結合テスト」が混ざることで、単体テスト全体のテンポが再び悪くなってしまいます。
ここでプロのアーキテクトが使うのが、「テストの分割戦略（カスタムソースセットによる分離）」です。
- Unit Tests (単体テスト): 常に数秒で終わるべき。コード変更のたびに実行する。
- Integration Tests (結合テスト): 時間がかかる。CIや手動の特定タイミングでのみ実行する。
これをGradleで美しく実現する設定がこちらです。
`build.gradle` への結合テストタスク追加
// build.gradle に追記・調整
// 1. 結合テスト用の「ソースセット」を定義する
sourceSets {
integrationTest {
java.srcDir file(‘src/integrationTest/java’)
resources.srcDir file(‘src/integrationTest/resources’)
compileClasspath += sourceSets.main.output + configurations.testCompileClasspath
runtimeClasspath += sourceSets.main.output + configurations.testRuntimeClasspath
}
}
// 結合テスト用の依存関係をメインのテストから継承
configurations {
integrationTestImplementation.extendsFrom testImplementation
integrationTestRuntimeOnly.extendsFrom testRuntimeOnly
}
// 2. 結合テストを実行する専用のタスクを定義
task integrationTest(type: Test) {
description = ‘Runs the integration tests.’
group = ‘verification’
// 結合テスト用のソースセットを指定
testClassesDirs = sourceSets.integrationTest.output.classesDirs
classpath = sourceSets.integrationTest.runtimeClasspath
useJUnitPlatform()
// 結合テストはリソース競合を避けるため、あえて直列か、独立したワーカーで実行するなどのチューニングが可能
shouldRunAfter test
}
この構成にすると、普段の開発時は以下のようにコマンドを使い分けることができます。
- 普段のコーディング中（高速な単体テストのみ実行）:
./gradlew test
- Pull Request作成前やCIでの最終確認（重い結合テストも含めて全実行）:
./gradlew test integrationTest
「軽量な単体テスト」と「重量級の結合テスト」のライフサイクルを完全に切り離すことで、あなたの毎日のコーディングリズムを絶対に途切れさせません。
—
先輩エンジニアからのメッセージ
今回は、Maven/GradleエコシステムにおけるJUnit 5の並列実行と、実務で絶対に知っておくべきテスト分割戦略について解説しました。
「テストが遅い」という小さなストレスの積み重ねは、開発者のモチベーションや集中力を確実に削っていきます。ビルドツールの仕組みを正しく理解し、適切な設定を施すことで、開発環境は驚くほど快適に生まれ変わります。
ぜひ、あなたのプロジェクトでも今日からこの設定を取り入れて、爆速のフィードバックループを手に入れてみてください。毎日のコーディングが、きっともっと楽しくなりますよ！