【 Java Unit Test學習】- 手把手寫 Java Unit Test單元測試，建立程式碼防護網 (1)

java unit test software engineering debugging

a5266290x 2026-05-12 13:56:02 ‧ 121 瀏覽

分享至

首頁圖
你有過這種經驗嗎？明明只改了一行看似無關緊要的代碼，結果上線後，接到系統崩潰的電話，翻遍整個專案才發現問題只是刪了不該刪除的判斷!

不聊深奧的架構，我們來手把手建立起那道讓晚上能安心睡覺的"第一道代碼防護網"!

此篇我們可以學到 :

為何要寫Unit Test
寫出屬於自己專案的 Unit Test

為何要寫 Unit Test :

省錢（早期糾錯）：在開發階段修 Bug 只要幾分鐘；上線後修 Bug 可能要因為此錯誤需修正資料、排除後續異常，動員整個團隊處理 (筆者還曾經在會計人員旁罰站~^^ )。
省心（重構保障）：當我們修改舊程式碼時，測試就像「防護網」，一鍵通知是否不小心弄壞了別的功能。
省力（活的文件）：測試案例直接示範了程式碼「該如何運作」，比任何過時的開發文件都更可靠，也有現行參數可以測試使用。

寫出屬於自己專案的 Unit Test

下列為我們案例會使用的程式碼
GitHub : https://github.com/KuangHung/java.git
IDE : IntelliJ IDEA Community Edition
JDK : Oracle Open Jdk 21.0.3

首先，Unit Test 使用的套將維護在 pom.xml 中

  <dependency>
   <groupId>junit</groupId>
   <artifactId>junit</artifactId>
   <scope>test</scope>
  </dependency>

IDE 的 JDK 可由此路徑確認

確定好環境後，我們就可以開始撰寫第一段程式碼，下列程式碼為取得 Cookie 的資料，並且印出 Cookie 的 User Name 案例

 @GetMapping("/getCookie")
 public String getCookie(HttpServletRequest request) {
  String username = "";
  System.out.println("getCookie");
  Cookie[] cookies = request.getCookies();
  if (cookies != null) {
   for (Cookie cookie : cookies) {
    System.out.println(cookie.getName());
    if ("username".equals(cookie.getName())) {
     username = cookie.getValue();
     // 在這裡處理 Cookie 的值
     break;
    }
   }
  }
  System.out.println("getCookie username : "+username);
  return username;
 }

通常，如果此段程式碼會做為 API 使用，因此我們需要透過第三方工具如 Postman 或真正啟動一個網頁前端，才能打到後端 API ，費時又費力。

此時我們可以考慮直接寫一個對應的 Unit Test 來直接測試程式，案例程式如下 :

藍框為被測試的程式，紅框為測試的 Unit Test

 // 為需要被測試的該支程式，我們會需要設定，此設定將模擬的 Mock 物件注入到測試目標
 @InjectMocks
 private HelloController helloController;

 // 用來模擬被測試的程式中，所有伺服器的請求
 @Mock
 private HttpServletRequest request;

 // 執行Unit Test ，初始化所有的 Mock 
 @Before
 public void setup() {
  MockitoAnnotations.initMocks(this);
 }

 /**
  * 測試用途：驗證 Controller 是否能正確從 Cookie 中提取 username
  */
 @Test
 public void getCookie_Test() {
  String username = "john_doe";

  // 1. 建立一個模擬的 Request 物件
  request = Mockito.mock(HttpServletRequest.class);

  // 2. 定義行為：當呼叫 getCookies() 時，回傳內含指定 username 的 Cookie 陣列
  Cookie[] cookies = {new Cookie("username", username)};
  Mockito.when(request.getCookies()).thenReturn(cookies);

  // 3. 執行測試目標方法
  String result = helloController.getCookie(request);

  // 4. 驗證：結果不應為空，且必須等於預期的內容
  Assert.assertNotNull(result);
  Assert.assertEquals(username, result);
 }

執行第一次測試 :