Java Private 私有方法如何测试

在 Java 中，private 方法本身是不推荐直接测试的，因为单元测试应当关注对外可观察的行为，而不是内部实现细节。但在实际开发中，有时确实需要验证 private 方法（例如遗留代码、复杂算法等）。下面系统介绍几种可行方案及其适用场景。

✅ 推荐做法（优先）

✅ 1. 通过 public / protected 方法间接测试（最佳实践）

private 方法一定会被某个 public 方法调用，否则它就是死代码。

public class OrderService {

    public int calculateTotal(int price, int count) {
        return price * count + calculateTax(price, count);
    }

    private int calculateTax(int price, int count) {
        return (int)(price * count * 0.1);
    }
}

测试方式

@Test
void testCalculateTotal() {
    OrderService service = new OrderService();
    assertEquals(110, service.calculateTotal(100, 1));
}

✅ 优点

• 不破坏封装
• 重构安全
• 符合单元测试理念

❌ 缺点

• 无法直接验证 private 方法逻辑

✅ 次优方案（在必要时使用）

✅ 2. 改为 package-private / protected（推荐重构方式）

class OrderService { // 非 public 类

    int calculateTax(int price, int count) { // package-private
        return (int)(price * count * 0.1);
    }
}

测试类放在同一个 package 下即可测试。

✅ 优点

• 不破坏设计
• 可测试性强
• 比反射优雅

✅ 3. 使用反射测试 private 方法（不推荐但可用）

@Test
void testPrivateMethod() throws Exception {
    OrderService service = new OrderService();

    Method method = OrderService.class
            .getDeclaredMethod("calculateTax", int.class, int.class);
    method.setAccessible(true);

    int result = (int) method.invoke(service, 100, 1);
    assertEquals(10, result);
}

✅ 适用场景

• 遗留代码
• 无法修改源码
• 临时调试

❌ 缺点

• 脆弱（方法名/签名改了就挂）
• 可读性差
• 破坏封装

✅ 4. 使用测试框架工具（本质仍是反射）

示例：Spring 的 ReflectionTestUtils

import org.springframework.test.util.ReflectionTestUtils;

@Test
void testPrivateMethod() {
    OrderService service = new OrderService();

    int result = (int) ReflectionTestUtils.invokeMethod(
            service, "calculateTax", 100, 1);

    assertEquals(10, result);
}

✅ 优点

• 代码稍简洁
• Spring 项目常用

✅ 5. 抽取到独立类（设计层面解决）

class TaxCalculator {
    public int calculate(int price, int count) {
        return (int)(price * count * 0.1);
    }
}

class OrderService {
    private final TaxCalculator taxCalculator = new TaxCalculator();

    public int calculateTotal(int price, int count) {
        return price * count + taxCalculator.calculate(price, count);
    }
}

✅ 优点

• 可测试性最好
• 符合单一职责原则

✅ 总结对比

✅ 一句话结论

private 方法不需要单独测试，除非它复杂到需要单独存在，那就应该被重构。

如果你愿意，可以把你的具体代码贴出来，我可以帮你判断最合理的测试方式。