Java案例怎么编写JUnit测试？

wen java案例 2026-06-08 49

Java案例中如何编写高质量JUnit测试：从入门到实战

目录导读

为什么Java开发必须掌握JUnit测试？
JUnit测试环境搭建与核心注解解析
实战案例：单元测试编写全流程（含代码示例）
常见陷阱与最佳实践（问答环节）
测试覆盖率与持续集成联动

为什么Java开发必须掌握JUnit测试？

在企业级Java开发中，单元测试是保证代码质量的基石，据统计，引入自动化测试的项目缺陷率可降低40%以上，JUnit作为Java生态最主流的测试框架,能帮助开发者：

Java案例怎么编写JUnit测试？

快速验证业务逻辑：例如电商系统中计算折扣、用户权限校验等核心方法
保障重构安全：修改代码后一键运行测试，杜绝回归缺陷
文档化代码行为：测试用例本身就是最精确的功能说明文档

关键点：JUnit测试不是“额外工作”,而是提升开发效率的杠杆工具。

JUnit测试环境搭建与核心注解解析

1 环境配置（Maven项目示例）

<dependency>
    <groupId>org.junit.jupiter</groupId>
    <artifactId>junit-jupiter</artifactId>
    <version>5.10.0</version>
    <scope>test</scope>
</dependency>

2 必须掌握的6个JUnit注解

注解	用途	执行时机
`@Test`	标记测试方法	每次运行测试
`@BeforeEach`	每个@Test方法前执行	常用于初始化对象
`@AfterEach`	每个@Test方法后执行	释放资源
`@BeforeAll`	所有测试前执行一次	数据库连接等，需static
`@AfterAll`	所有测试后执行一次	关闭连接
`@Disabled`	临时禁用测试	跳过失败用例

实战案例：编写一个用户登录功能的JUnit测试

场景描述

假设有一个UserService类，提供login(String username, String password)方法，返回LoginResult对象（包含是否成功、错误信息）。

步骤1：编写待测试业务类

public class UserService {
    public LoginResult login(String username, String password) {
        if (username == null || username.trim().isEmpty()) {
            return new LoginResult(false, "用户名不能为空");
        }
        if (!"admin".equals(username) || !"123456".equals(password)) {
            return new LoginResult(false, "用户名或密码错误");
        }
        return new LoginResult(true, "登录成功");
    }
}

步骤2：创建测试类（遵循命名规范`XxxTest`）

import org.junit.jupiter.api.*;
import static org.junit.jupiter.api.Assertions.*;
class UserServiceTest {
    private UserService userService;
    @BeforeEach
    void setUp() {
        userService = new UserService();  // 每次测试前创建新实例
    }
    @Test
    void testLoginSuccess() {
        LoginResult result = userService.login("admin", "123456");
        assertTrue(result.isSuccess());
        assertEquals("登录成功", result.getMessage());
    }
    @Test
    void testLoginWithNullUsername() {
        LoginResult result = userService.login(null, "123456");
        assertFalse(result.isSuccess());
        assertEquals("用户名不能为空", result.getMessage());
    }
    @Test
    void testLoginWithWrongPassword() {
        LoginResult result = userService.login("admin", "wrong");
        assertFalse(result.isSuccess());
        assertEquals("用户名或密码错误", result.getMessage());
    }
}

步骤3：常用断言方法速查

assertEquals(expected, actual)：判断两个值相等
assertTrue(condition)：判断条件为真
assertNotNull(object)：对象非空
assertThrows(ExceptionClass, () -> methodCall)：验证异常抛出

常见陷阱与最佳实践（问答环节）

Q1：如何测试包含数据库调用的方法？

答：使用Mockito创建模拟对象，避免依赖真实数据库,示例：

@Mock
private UserRepository userRepository;
@InjectMocks
private UserService userService;
@Test
void testFindUser() {
    when(userRepository.findById(1)).thenReturn(Optional.of(new User()));
    User user = userService.findUser(1);
    assertNotNull(user);
}

Q2：测试方法命名有什么规范？

答：推荐使用「测试场景_预期结果」格式，如：shouldThrowExceptionWhenUsernameIsEmpty(),避免使用test1这类无意义命名。

Q3：如何保证测试不依赖执行顺序？

答：每个@Test方法独立运行，通过@BeforeEach重置状态,禁止在不同测试间共享可变数据。

Q4：测试覆盖率要达到多少？

答：核心业务逻辑建议≥80%，关键方法需100%覆盖边界条件（空值、异常值、最大值等）,可使用JaCoCo插件生成可视化报告。

Q5：如何处理测试中的日志输出？

答：使用@DisplayName注解添加描述：

@Test
@DisplayName("用户名为空时返回错误信息")
void testNullUsername() { ... }

测试覆盖率与持续集成联动

1 配置JaCoCo（Maven示例）

<plugin>
    <groupId>org.jacoco</groupId>
    <artifactId>jacoco-maven-plugin</artifactId>
    <version>0.8.11</version>
    <executions>
        <execution>
            <goals><goal>prepare-agent</goal></goals>
        </execution>
        <execution>
            <id>report</id>
            <phase>test</phase>
            <goals><goal>report</goal></goals>
        </execution>
    </executions>
</plugin>

2 CI/CD集成（GitHub Actions示例）

name: Java CI
on: [push]
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - name: Run tests
        run: mvn test