Java / 系统课时

单元测试基础

单元测试基础

单元测试用自动化断言验证一个类或方法的公开行为,为修改和重构提供可重复的反馈。本课使用 JUnit 5 覆盖正常结果与异常边界,并通过 Maven 验证测试是否通过。

学习目标

  • 使用 Arrange、Act、Assert 组织测试步骤
  • 用断言验证返回值与异常契约
  • 通过 Maven 运行测试并读取结果

测试规则

测试应验证公开行为,而不是私有字段或内部调用次数。一个测试聚焦一个清晰场景,并自行准备数据,避免依赖执行顺序、当前时间、外部网络和共享可变状态。

典型路径之外还要覆盖边界值与非法输入。修复缺陷时,先补充能够稳定复现问题的失败测试,再修改实现,最后确认整个测试集通过。

主示例与运行

以下文件是同一 Maven 项目的片段示例,需按给定路径组合运行。项目使用 Java 17、JUnit Jupiter 和 Maven Surefire。pom.xml:

xml
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.example</groupId>
    <artifactId>calculator</artifactId>
    <version>1.0.0</version>

    <properties>
        <maven.compiler.release>17</maven.compiler.release>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <junit.version>5.10.2</junit.version>
    </properties>

    <dependencies>
        <dependency>
            <groupId>org.junit.jupiter</groupId>
            <artifactId>junit-jupiter</artifactId>
            <version>${junit.version}</version>
            <scope>test</scope>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>3.13.0</version>
            </plugin>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-surefire-plugin</artifactId>
                <version>3.2.5</version>
            </plugin>
        </plugins>
    </build>
</project>

生产代码 src/main/java/com/example/Calculator.java:

java
package com.example;

public class Calculator {
    public int divide(int left, int right) {
        if (right == 0) {
            throw new IllegalArgumentException("除数不能为 0");
        }
        return left / right;
    }
}

测试代码 src/test/java/com/example/CalculatorTest.java:

java
package com.example;

import org.junit.jupiter.api.Test;

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

class CalculatorTest {
    private final Calculator calculator = new Calculator();

    @Test
    void shouldDivideTwoIntegers() {
        int result = calculator.divide(10, 2);
        assertEquals(5, result);
    }

    @Test
    void shouldRejectZeroDivisor() {
        IllegalArgumentException error = assertThrows(
                IllegalArgumentException.class,
                () -> calculator.divide(10, 0));

        assertEquals("除数不能为 0", error.getMessage());
    }
}

在项目根目录运行:

bash
mvn test

预期输出中的关键结果:

text
Tests run: 2, Failures: 0, Errors: 0, Skipped: 0
BUILD SUCCESS

Maven 日志中的时间、路径和下载信息可能不同;验收以测试数、失败数和 BUILD SUCCESS 为准。

边界与排查

测试通过但没有断言并不代表行为正确;每个测试至少要验证返回值、状态变化或异常契约之一。浮点数比较应使用带允许误差的断言重载,避免二进制浮点表示造成误判。

若测试单独运行通过、批量运行失败,优先检查静态变量、共享文件和执行顺序依赖。若 Maven 没有发现测试,检查测试类路径、类名模式、JUnit 版本与 Surefire 配置。

按自己的节奏,确认真正理解。

目录与阅读设置

记录一个想法

单元测试基础

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通