在使用 lombok `@builder` 注解修饰泛型类（如 `response
Lombok 的 @Builder 是提升 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() // ❌ 编译错误！
.status("ok")
.total(total)
.page(page) // 错误：期望 List<Object>，但传入 List<Article>
.build();此时编译器报错：
The method page(List<Object>) in the type Response.ResponseBuilder<Object> is not applicable for the arguments (List<Article>)
根本原因在于：Java 类型推断无法穿透方法链。Response.builder() 调用时，编译器尚未结合后续 .page(page) 或最终赋值目标类型 Response<Article> 做上下文推断，而是默认推断为最宽泛的 ResponseBuilder<Object>（即 T = Object），导致后续泛型方法签名不兼容。
✅ 正确解法是显式提供类型见证（Type Witness）：
Response<Article> response = Response.<Article>builder() // ✅ 显式指定 T = Article
.status("ok")
.total(total)
.page(page)
.build();该语法 <Article> 告诉编译器：builder() 应返回 ResponseBuilder<Article>，从而确保 .page(List<Article>) 方法可用。
? 进阶提示：
- 若项目中大量使用泛型 Builder，可考虑配合静态导入简化写法（但类型见证仍不可省略）；
- 避免依赖 IDE 自动补全的 Response.builder() —— 它通常不会自动插入类型见证；
- Lombok 1.18.30+ 对部分泛型场景增强了推断支持，但仍无法覆盖链式调用全场景，类型见证仍是可靠方案；
- 如需更灵活的泛型构建逻辑（如 builder 方法本身带泛型参数），可手动编写 builder 类或改用 @Builder(builderMethodName = "newBuilder") + 自定义静态工厂方法。
总之，这不是 Lombok 的缺陷，而是 Java 泛型类型系统的设计约束。掌握类型见证语法，即可优雅、安全地将 @Builder 与泛型深度结合。
