lombok 的 `@builder` 与泛型类配合时，java 类型推导无法自动识别构建器的泛型参数，需通过类型见证（type witness）显式指定，否则编译报错。
在使用 Lombok 的 @Builder 注解定义泛型类（如 Response
@Builder public class Response{ private String status; private long total; private List page; }
当你尝试构建 Response
long total = getTotalItemsCount(); Listpage = getPage(); Response response = Response.builder() // ❌ 推断为 ResponseBuilder
问题根源在于：Java 编译器在调用静态工厂方法 builder() 时，不会向前查看后续链式调用或目标变量类型，而是基于方法签名独立推断类型参数。由于 Response.builder() 是泛型静态方法 public static
✅ 正确解法是添加类型见证（Type Witness），显式告知编译器泛型参数：
Responseresponse = Response. builder() // ✅ 显式指定 T = Article .status("ok") .total(total) .page(page) .build();
? 类型见证 是 Java 语言特性，与 Lombok 无关，但却是解决该问题的唯一标准方式。
补充说明与最佳实践
-
不可省略泛型声明：即使目标变量已声明为 Response
，也不能省略 . —— 类型推断不会“回溯”。 -
Builder 类型安全：一旦指定
，后续所有泛型字段（如 page）的方法签名将严格绑定为 List ，获得完整编译期检查。 -
避免 @Builder(toBuilder = true) 的泛型陷阱：若同时启用 toBuilder()，其返回类型同样需类型见证，例如 response.toBuilder()
()。 -
替代方案考虑：若频繁使用且类型见证冗余，可考虑：
- 定义非泛型子类（如 ArticleResponse extends Response
），再对其加 @Builder； - 使用 @AllArgsConstructor(access = AccessLevel.PRIVATE) + 静态工厂方法（牺牲链式语法，换取类型推导友好性）。
- 定义非泛型子类（如 ArticleResponse extends Response
总之，这不是 Lombok 的缺陷，而是 Java 泛型类型推断的固有行为。掌握类型见证语法，即可安全、高效地在泛型类中享受 @Builder 带来的开发便利。
