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