Mapstruct Mapper报错：Cannot Find Symbol问题解决咨询

问题原因 #

你遇到的错误是因为Mapstruct误解了映射意图：它自动生成了IdRelationEntity到IdDto的转换方法，但该方法无法访问原映射方法中的IpEntity source变量，导致调用自定义方法时找不到符号。本质是Mapstruct错误地将TargetDto.id的映射拆分为从IpEntity.id（IdRelationEntity实例）转换，而非使用你提供的从整个IpEntity生成IdDto的自定义逻辑。

修复方案 #

方案1：使用qualifiedByName明确指定自定义映射逻辑（推荐）

通过@Named标记自定义方法，并用source="."指定使用整个IpEntity作为输入，彻底避免Mapstruct自动生成错误的转换方法。

修改后的Mapper代码：

import org.mapstruct.Mapper;
import org.mapstruct.Mapping;
import org.mapstruct.Named;

@Mapper(componentModel = "spring") // 根据你的项目组件模型调整，比如"cdi"或默认
public interface YourMapper {

    // 用source="."表示使用整个IpEntity对象作为id字段的映射源
    @Mapping(target = "id", source = ".", qualifiedByName = "getIdDtoBasedOnFlag")
    TargetDto toTargetDto(IpEntity source);

    // 用@Named标记自定义方法，供qualifiedByName调用
    @Named("getIdDtoBasedOnFlag")
    default IdDto getIdDtoBasedOnFlag(IpEntity src) {
        IdDto cd = new IdDto();
        // 注意：如果idType是Mapper的成员变量，需改为通过@Context注入或方法参数传递（见下方补充）
        if ("standard".equalsIgnoreCase(idType)) {
            StndIdRelationEntity c = src.getPrimaryId();
            cd.setIdCode(c.getIdNumber());
            cd.setId(c.getId().toString());
            cd.setIdName(c.getIdName());
        } else {
            IdRelationEntity c = src.getId();
            cd.setIdCode(c.getSourceCode());
            cd.setId(c.getId().toString());
            cd.setIdName(c.getIdName());
        }
        return cd;
    }
}

方案2：修正expression的参数传递（兼容原有写法）

如果你坚持使用expression，需确保Mapstruct不会自动生成中间转换方法。可以通过在Mapper接口中手动实现IdRelationEntity到IdDto的转换方法，覆盖自动生成的逻辑：

@Mapping(target = "id", expression = "java(getIdDtoBasedOnFlag(source))")
public TargetDto toTargetDto(IpEntity source);

default IdDto getIdDtoBasedOnFlag(IpEntity src) {
    // 原逻辑不变
}

// 手动实现转换方法，避免Mapstruct自动生成错误版本
default IdDto idRelationEntityToIdDto(IdRelationEntity entity) {
    // 这里可以留空或实现你需要的逻辑，因为我们的目标是用自定义方法生成IdDto
    return null;
}

补充：关于idType的潜在问题 #

你的自定义方法中使用的idType变量，如果是Mapper接口的成员变量，Mapstruct生成的实现类不会继承该变量，会导致新的编译错误。解决方式：

1. 将idType作为方法参数传入，并通过@Context标记（避免作为映射字段处理）：

@Named("getIdDtoBasedOnFlag")
default IdDto getIdDtoBasedOnFlag(IpEntity src, @Context String idType) {
    // 使用传入的idType
}

// 映射方法中传递idType
@Mapping(target = "id", source = ".", qualifiedByName = "getIdDtoBasedOnFlag")
TargetDto toTargetDto(IpEntity source, @Context String idType);

2. 如果idType是全局配置，可通过构造注入的方式将其注入到Mapper实现类中（需将Mapper改为抽象类而非接口）。

内容的提问来源于stack exchange，提问作者Bhavin