JUnitPerf 使用手冊完整中譯版：單元測試的效能擴充利器

簡介：將效能測試納入單元測試體系

JUnitPerf 是建立在 JUnit 之上的效能測試擴充框架，讓開發者能以撰寫單元測試的方式，自動化執行響應時間與吞吐量驗證。它不是取代 LoadRunner/JMeter 等專業壓測工具，而是在「重構保護網」層面提供持續的效能回歸守護。

核心價值主張

• 零侵入擴充：裝飾既有 JUnit 測試案例，不修改原測試碼
• 獨立執行：效能測試套件可獨立於功能測試運行，避免拖慢 CI 流程
• 重構守護：確保演算法優化、資源池調整不導致效能退化
• 投資報酬比高：專注於有明確 SLA 的關鍵路徑，而非全鏈路壓測

核心組件：兩大測試裝飾器

1. TimedTest — 響應時間守門員

// 基本用法：等待測試完成，超過 maxElapsedTime 則失敗
long maxElapsedTime = 1000; // 1秒
Test testCase = new ExampleTestCase("testOneSecondResponse");
Test timedTest = new TimedTest(testCase, maxElapsedTime);

// 進階：超時即終止 (fail-fast)，第三參數 false 表示不等待完成
Test timedTestFastFail = new TimedTest(testCase, maxElapsedTime, false);

計時範圍：包含 `setUp()` + `testXXX()` + `tearDown()` 總時間。設定閾值時務必預留 fixture 耗時。

2. LoadTest — 並發負載模擬器

// 基本：10 用戶並發各執行 1 次
int users = 10;
Test loadTest = new LoadTest(testCase, users);

// 帶延遲：ConstantTimer (固定延遲) / RandomTimer (隨機延遲)
Timer timer = new ConstantTimer(1000); // 1秒間隔
Test loadTestWithDelay = new LoadTest(testCase, users, timer);

// 多次迭代：每用戶執行 20 次
int iterations = 20;
Test repeatedTest = new RepeatedTest(testCase, iterations);
Test loadTestIterated = new LoadTest(repeatedTest, users, timer);

// 簡寫：LoadTest(testCase, users, iterations, timer)
Test loadTestCompact = new LoadTest(testCase, users, iterations, timer);

// 有狀態測試：每執行緒獨立實例 (TestFactory / TestMethodFactory)
Test factory = new TestFactory(ExampleStatefulTest.class);
Test loadTestStateful = new LoadTest(factory, users);

進階組合：TimedTest + LoadTest 雙重保障

場景 A：吞吐量測試 — 整體在 1.5 秒內完成 10 併發

public static Test suite() {
    int maxUsers = 10;
    long maxElapsedTime = 1500;
    Test testCase = new ExampleTestCase("testOneSecondResponse");
    Test loadTest = new LoadTest(testCase, maxUsers);
    Test timedTest = new TimedTest(loadTest, maxElapsedTime); // 外層計時
    return timedTest;
}

場景 B：響應時間測試 — 每個併發用戶必須在 1 秒內完成

public static Test suite() {
    int maxUsers = 10;
    long maxElapsedTime = 1000;
    Test testCase = new ExampleTestCase("testOneSecondResponse");
    Test timedTest = new TimedTest(testCase, maxElapsedTime); // 內層計時
    Test loadTest = new LoadTest(timedTest, maxUsers);       // 外層併發
    return loadTest;
}

效能測試套件組織

public class ExamplePerfTestSuite {
    public static Test suite() {
        TestSuite suite = new TestSuite();
        suite.addTest(ExampleTimedTest.suite());
        suite.addTest(ExampleLoadTest.suite());
        return suite;
    }
    public static void main(String[] args) {
        junit.textui.TestRunner.run(suite());
    }
}

關鍵概念深度解析

Waiting vs Non-Waiting TimedTest

Atomic vs Non-Atomic LoadTest

已知限制與避坑指南

• 計時粒度限制：最小單位為整個 `testXXX()` 含 fixture，無法精確到單行程式碼。需精細計時請在測試內自行用 `System.nanoTime()`
• 非專業壓測工具：無法模擬真實網路拓撲、思考時間、斜率啟動、分散式注入
• JVM 閾值：併發用戶數過多導致效能急劇下降，實際上限視 JVM 實作而定 (建議 < 50 併發)
• 執行緒組洩漏：Atomic 模式下若被測碼衍生脫離群組的執行緒，將導致無限等待

安裝與建置快速入門

# Windows
set JUNITPERF_HOME=C:\path\to\junitperf
set CLASSPATH=%CLASSPATH%;%JUNITPERF_HOME%\lib\junitperf-1.9.jar

# Unix/Linux
export JUNITPERF_HOME=/path/to/junitperf
chmod -R a+x $JUNITPERF_HOME
export CLASSPATH=$CLASSPATH:$JUNITPERF_HOME/lib/junitperf-1.9.jar

# Ant 建置與驗證
cd $JUNITPERF_HOME
ant jar      # 建置
ant test     # 執行內建測試驗證安裝

實戰建議：效能測試的 TDD 循環

1. 功能測試通過 → 確立基線行為
2. Profiling 找出熱點 → 設定效能預算 (SLA)
3. 撰寫 JUnitPerf 測試 (紅燈：未優化前必失敗)
4. 微調優化 → 重跑測試 → 綠燈
5. 納入 CI 夜間建置，持續守護不退化

JUnitPerf 的核心哲學：「效能也是功能的一種，應該像功能測試一樣被自動化、被版本化、被持續驗證。」