本文介绍在不直接测试私有方法的前提下，通过验证公共方法的可观察行为（如返回对象状态、字段值等），间接保障私有逻辑（如 transform 中 extras 的计算）被正确执行，从而防止关键业务逻辑遗漏。
本文介绍在不直接测试私有方法的前提下，通过验证公共方法的**可观察行为**（如返回对象状态、字段值等），间接保障私有逻辑（如 `transform` 中 `extras` 的计算）被正确执行，从而防止关键业务逻辑遗漏。
在 Java 单元测试实践中，一个广泛接受的原则是：只测试公共 API 的行为，而非内部实现细节。私有方法（如示例中的 transform()）本身不是契约的一部分，其存在、签名或调用路径可能随重构而变化；但其产生的业务影响必须稳定且可验证——例如，extras 字段是否被正确赋值并最终体现在 CancelOrder 的响应结构中。
因此，正确的测试策略不是“如何调用 transform()”，而是：“当调用 generateCancelOrder(...) 时，最终返回的 CancelOrder 对象中，是否包含符合预期的 premiumSummary（进而可推导出 extras 的值）？”
✅ 推荐做法：端到端验证公共方法输出
由于 extras 最终通过 pennyCancelOrderDetails.getOrderSummary() 传递至 CancelOrderResponse.builder().premiumSummary(...)，而 getOrderSummary() 返回的是 PennyOrderDetails 的摘要对象（通常含 extras 字段），我们应聚焦于该摘要内容的断言。
假设 OrderSummary 类结构如下（需根据实际调整）：
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
立即学习“Java免费学习笔记（深入）”；
public class OrderSummary {
private String extras;
// ... other fields, getters
public String getExtras() { return extras; }
}则对应单元测试可编写为：
@Test
void generateCancelOrder_setsExtrasFromVoluntaryExtrasCalculation() {
// Given
CurrentState currentState = CurrentState.builder()
.voluntaryExtras(Arrays.asList(
VoluntaryExtra.builder().code("BREAKDOWN").amount(45.0).build(),
VoluntaryExtra.builder().code("GLASS").amount(22.5).build()
))
.build();
Contract contract = new Contract(); // mock or stub as needed
// Mock dependency to control PennyOrderDetails response
PennyOrderDetails mockDetails = PennyOrderDetails.builder()
.orderSummary(OrderSummary.builder()
.extras("BREAKDOWN:45.0,GLASS:22.5") // ← expected computed value
.build())
.build();
when(pennyCancelOrderService.requestCancelOrder(any(Context.class)))
.thenReturn(mockDetails);
// When
CancelOrder result = target.generateCancelOrder(currentState, contract);
// Then
assertThat(result.getPremiumSummary().getExtras())
.isEqualTo("BREAKDOWN:45.0,GLASS:22.5");
}? 关键洞察：该测试不关心 transform() 是否被调用、是否内联、甚至是否存在——它只验证：只要输入 currentState 含特定 voluntaryExtras，最终 CancelOrder 的 extras 就必须匹配 VoluntaryExtras.calculateVoluntaryExtrasAmount(...) 的预期输出。这正是业务契约所在。
⚠️ 注意事项与最佳实践
- 避免反射测试私有方法：使用 Method.setAccessible(true) 强行调用私有方法虽技术可行，但会使测试脆弱（易因重命名、参数变更、提取逻辑等失败），违背测试稳定性原则。
- 确保依赖可模拟：pennyCancelOrderService 必须可被 Mockito 或其他框架 mock，否则无法隔离 generateCancelOrder 的行为，也无法控制 PennyOrderDetails 的构造。
- 覆盖边界场景：除正常流程外，还需测试 currentState.getVoluntaryExtras() 为 null、空集合、含无效数据等情况，验证 calculateVoluntaryExtrasAmount() 的健壮性是否被正确传导。
- 将计算逻辑显式暴露（可选进阶）：若 VoluntaryExtras.calculateVoluntaryExtrasAmount(...) 是纯函数且被多处复用，建议将其抽取为 public static 工具方法，并为其单独编写高覆盖率的单元测试——这比测试调用它的私有方法更清晰、更可持续。
✅ 总结
测试的目标从来不是“代码是否按某种方式写了”，而是“系统是否按约定工作了”。当私有方法承载关键业务逻辑（如 extras 的生成）时，最可靠、最符合测试金字塔原则的方式，是通过公共方法的输出结果反向验证该逻辑是否生效。这种基于契约的测试既保障质量，又支持安全重构，是专业 Java 工程团队推荐的实践路径。
