MapStruct泛型类型映射报错：无法为泛型变量生成映射方法

问题原因 #

MapStruct编译时注解处理器需要明确的源/目标类型信息，泛型接口中的<A, M>是类型变量，编译阶段未被具体类型替换，因此无法生成对应的映射方法。

可行解决方案 #

方案1：抽象类+具体子类指定泛型 #

将泛型定义在抽象类中，通过具体子类继承并指定实际泛型类型，让MapStruct能获取明确的类型信息生成实现。

1. 定义泛型抽象类：

public abstract class AccountMapper<A extends BaseAccount, M extends BaseAccountMongo> {
    public abstract A map(M baseAccountMongo);
}

2. 创建具体的Mapper接口（指定泛型参数）：

@Mapper
public interface AccountToMongoMapper extends AccountMapper<Account, AccountMongo> {
    AccountToMongoMapper INSTANCE = Mappers.getMapper(AccountToMongoMapper.class);
}

此时MapStruct会为AccountToMongoMapper生成完整的映射实现，因为泛型已被具体类型Account和AccountMongo替换。

方案2：直接定义带具体类型的Mapper接口 #

如果不需要通用泛型逻辑，直接针对每种具体类型定义Mapper接口：

@Mapper
public interface AccountToMongoMapper {
    AccountToMongoMapper INSTANCE = Mappers.getMapper(AccountToMongoMapper.class);
    
    Account map(AccountMongo baseAccountMongo);
}

这种方式更直接，适合类型较少的场景。

注意事项 #

• 不要在泛型接口中直接使用Mappers.getMapper()，因为泛型类型擦除后，MapStruct无法识别具体的映射类型。
• 若有公共映射逻辑，优先用抽象类封装，子类继承复用，减少重复代码。

内容的提问来源于stack exchange，提问作者Willian Tártaro