JUnit 5 参数化测试中支持可为空的 Java 日期/时间参数

在 JUnit 5 的参数化测试中，处理 Java 日期和时间类型（如 LocalDate、LocalDateTime 等）时，开发人员经常会遇到一个限制：无法通过参数化测试的输入直接传递 null 值。这个问题最近在 JUnit 5 社区中得到了解决，通过新增的功能使日期/时间参数能够接受 null 值。

问题背景

在 JUnit 5 的参数化测试中，当使用 @CsvSource 或类似注解提供测试数据时，如果尝试为日期/时间参数传递空字符串（期望转换为 null），系统会抛出 ArgumentConversionException。这是因为内置的 JavaTimeArgumentConverter 默认不允许空值转换。

例如，以下测试用例会失败：

@ParameterizedTest
@CsvSource({", 01.01.1970"})
void testWithNullDate(
    @JavaTimeConversionPattern("dd.MM.yyyy") LocalDate date) {
    // 期望 date 为 null，但实际上会抛出异常
}

解决方案

JUnit 5 团队通过为 @JavaTimeConversionPattern 注解新增 nullable 属性解决了这个问题。这个属性默认为 false 以保持向后兼容性，但可以显式设置为 true 来允许 null 值转换。

使用示例：

@ParameterizedTest
@CsvSource({", 01.01.1970", "01.01.1970, 01.01.1970"})
void test(
    @JavaTimeConversionPattern(value = "dd.MM.yyyy", nullable = true) LocalDate nullableDate,
    @JavaTimeConversionPattern("dd.MM.yyyy") LocalDate nonNullableDate) {
    // nullableDate 可以接受 null 值
    // nonNullableDate 保持原有行为，null 会抛出异常
}

实现细节

在实现上，JavaTimeArgumentConverter 现在会检查 nullable 属性的值。当设置为 true 时：

1. 如果输入字符串为 null 或空，转换器会返回 null
2. 如果输入字符串非空，则按照指定格式进行解析
3. 转换失败时，错误信息会提示用户检查格式或考虑启用 nullable 选项

最佳实践

1. 明确意图：只有当确实需要测试 null 值场景时才启用 nullable 属性
2. 格式验证：即使允许 null 值，也应确保非 null 值的格式正确
3. 文档说明：在团队内部文档中记录这种用法，特别是当项目中有大量日期/时间参数化测试时
4. 渐进采用：可以先将现有测试保持原样，只在需要测试 null 场景的新测试中使用此功能

总结

这个增强功能使得 JUnit 5 的参数化测试在处理日期/时间类型时更加灵活，能够覆盖更多边界情况。它体现了 JUnit 5 团队对实际开发需求的关注，同时也保持了框架的稳定性和向后兼容性。对于需要测试各种日期/时间输入（包括缺失值）场景的项目来说，这是一个有价值的改进。