如何为带@SuperBuilder注解的泛型类创建自定义构造方法？

我尝试为使用Lombok的@SuperBuilder注解的泛型类创建自定义构造方法，但编译器报错提示该构造方法已存在。此自定义构造方法在非泛型类中可正常工作，示例如下：

@SuperBuilder
public class MyRegularSuperObject {
    private final String someString;
    
    protected MyRegularSuperObject(MyRegularSuperObject.MyRegularSuperObjectBuilder<?,?> b) {
        someString = b.someString;
    }
}

但在带@SuperBuilder的泛型类中无法正常工作，示例如下：

@SuperBuilder
public class MyGenericSuperObject<T> {
    private final String someString;
    
    protected MyGenericSuperObject(MyGenericSuperObjectBuilder<T,?,?> b) {
        someString = b.someString;
    }
}

抛出如下异常：

error: constructor MyGenericSuperObject(MyGenericSuperObjectBuilder<T,?,?>) is already defined in class MyGenericSuperObject
@SuperBuilder
^
where T is a type-variable:
T extends Object declared in class MyGenericSuperObject

我猜测这可能是Lombok的问题，但首先想确认是否有明显遗漏的配置或写法，能让我为泛型类定义自定义构造方法？

这是Lombok处理泛型类@SuperBuilder时的行为差异导致的：

• 非泛型类场景下，Lombok会检测到你自定义了Builder参数的构造方法，因此不会自动生成该方法；
• 泛型类场景下，Lombok生成的构造方法签名和你自定义的签名存在冲突——Lombok生成的参数类型是MyGenericSuperObject<T>.MyGenericSuperObjectBuilder<T, ?, ?>（带外部类泛型限定），而你写的是MyGenericSuperObjectBuilder<T, ?, ?>，编译器会将两者视为同一签名，触发重复定义错误。

解决方法如下：

1. 严格匹配Lombok生成的完整签名
   给Builder类名加上外部类的泛型限定，确保签名完全一致：

   @SuperBuilder
   public class MyGenericSuperObject<T> {
       private final String someString;
       
       protected MyGenericSuperObject(MyGenericSuperObject<T>.MyGenericSuperObjectBuilder<T, ?, ?> b) {
           someString = b.someString;
       }
   }
   

2. 省略不必要的通配符或简化签名
   也可以直接使用外部类限定的Builder类型，省略泛型参数中的通配符（Lombok内部生成的签名会匹配这种写法）：

   @SuperBuilder
   public class MyGenericSuperObject<T> {
       private final String someString;
       
       protected MyGenericSuperObject(MyGenericSuperObject.MyGenericSuperObjectBuilder<T, ?, ?> b) {
           someString = b.someString;
       }
   }
   

3. 评估是否需要自定义构造方法
   如果你的自定义构造方法只是简单复制Builder字段，完全可以不用手动定义——@SuperBuilder会自动生成对应的构造方法。只有当你需要添加额外逻辑（比如参数校验、类型转换）时，才需要自定义。

如果以上写法仍然报错，建议升级Lombok到1.18.20及以上的稳定版本，后续版本对泛型类的@SuperBuilder处理做了优化。

内容的提问来源于stack exchange，提问作者Andreas Forslöv