使用Lombok SuperBuilder搭配容器校验注解出现类型不匹配问题

问题背景 #

我有一个使用Lombok @SuperBuilder 注解的ActivitiesModel类，为List<String>的泛型参数添加了jakarta.validation的@NotBlank注解，并使用静态常量作为注解的message属性。在通过Builder创建该类对象时，出现了**“Type mismatch: cannot convert from List to List”**的编译错误。

尝试过的两种临时方案：

• 将@SuperBuilder替换为@Builder和@AllArgsConstructor，问题解决但无法满足子类继承Builder的需求；
• 将注解的message改为字符串字面量，问题解决但会导致测试代码中消息字符串重复。

补充细节：该错误仅在容器泛型参数存在注解时出现，字段本身的@NotNull注解无影响。

问题1：为何Lombok在使用字符串字面量时能识别类型，使用静态常量则不行？ #

这是Lombok注解处理器在特定场景下的逻辑缺陷：

• 使用字符串字面量时，Lombok能直接在编译期解析到注解的完整元信息，生成@SuperBuilder代码时可以准确保留List<String>的具体泛型类型，不会出现泛型参数混淆。
• 当使用静态常量作为message值时，Lombok的注解处理器无法在编译期直接解析常量的最终值（需要依赖后续的常量解析流程），这会导致它处理泛型容器的注解时，错误地将泛型参数推断为通配符E而非String，最终生成的Builder代码出现类型不匹配的编译错误。

本质是Lombok对注解属性中常量引用的处理逻辑，没有和泛型容器的注解解析逻辑做好兼容，属于工具链的特定场景bug。

问题2：是否不应在测试中校验消息字符串，而应采用其他方式？ #

是的，直接校验消息字符串并非最佳实践，推荐两种更合理的方案：

方案一：使用消息码+国际化配置 #

• 定义静态常量作为消息码（而非完整消息），例如：public static final String NOT_BLANK_CODE = "validation.string.not_blank";
• 在国际化配置文件（如messages.properties）中配置对应消息：validation.string.not_blank=字符串不能为空
• 测试时仅校验错误码是否匹配，无需硬编码完整消息内容

方案二：统一管理消息常量，直接引用复用 #

• 将所有校验消息常量统一放到公共类（如ValidationMessages）中
• 测试代码直接引用该类的常量进行断言，避免重复硬编码
• 示例代码：

// 公共常量类
public class ValidationMessages {
    public static final String NOT_BLANK = "字符串不能为空";
}

// 测试类
@Test
void testListValidation() {
    ActivitiesModel model = ActivitiesModel.builder().items(List.of("")).build();
    Set<ConstraintViolation<ActivitiesModel>> violations = validator.validate(model);
    assertEquals(ValidationMessages.NOT_BLANK, violations.iterator().next().getMessage());
}

另外，也可以用临时绕过方案：在Builder创建代码中显式指定泛型类型，比如ActivitiesModel.builder().items(new ArrayList<String>()).build()，但这只是权宜之计，不如从测试策略上优化更彻底。

内容的提问来源于stack exchange，提问作者Mohit Sakhuja