如何使用MapStruct实现REST fields查询参数的运行时动态字段映射

MapStruct 基于编译期注解生成静态映射代码，本身不支持运行时动态指定映射字段，强行通过反射修改生成的映射逻辑会带来极高的维护成本和性能损耗，不推荐使用。

以下为三类可落地的实现思路，可根据项目场景选择：

方案1：MapStruct + 序列化层动态过滤（改动最小，适配绝大多数场景） #

无需修改现有MapStruct映射逻辑，仅在JSON序列化环节做字段剪裁即可：

• MapStruct 按原有逻辑完成全量字段到DTO的映射
• 解析请求的fields参数得到允许返回的字段集合
• 利用JSON序列化框架的动态过滤能力过滤非指定字段，以Jackson为例代码如下：

// 解析fields参数得到合法字段集合
Set<String> allowedFields = Arrays.stream(fields.split(","))
        .map(String::trim)
        .collect(Collectors.toSet());
// 构造Jackson动态过滤规则
FilterProvider filterProvider = new SimpleFilterProvider()
        .addFilter("dynamicFieldFilter", SimpleBeanPropertyFilter.filterOutAllExcept(allowedFields));
// 序列化得到剪裁后的JSON
String result = new ObjectMapper().setFilterProvider(filterProvider).writeValueAsString(fullDto);

• 补充说明：只需在对应DTO类上添加@JsonFilter("dynamicFieldFilter")注解即可，未传入fields参数时直接返回全量DTO，无需走过滤逻辑。

方案2：运行时动态映射框架方案（适合映射逻辑复杂、性能要求高的场景） #

如果需要在映射阶段就过滤冗余字段、避免无用字段的映射开销，可替换MapStruct为支持运行时动态配置的映射框架，可选框架包括Orika、ModelMapper：

• 以ModelMapper为例，动态映射示例代码：

ModelMapper modelMapper = new ModelMapper();
// 每次请求时根据字段列表动态配置映射规则
TypeMap<SourceEntity, TargetDTO> typeMap = modelMapper.typeMap(SourceEntity.class, TargetDTO.class);
// 清空原有隐式映射规则
typeMap.implicitMappings().forEach(typeMap::removeMapping);
// 仅添加允许的字段映射
allowedFields.forEach(field -> typeMap.addMapping(field, field));
// 执行映射得到仅包含指定字段的DTO
TargetDTO filteredDto = typeMap.map(sourceEntity);

方案3：自定义反射字段拷贝（轻量场景无额外依赖方案） #

如果项目没有引入其他映射框架的需求，且字段量级较小，可以基于反射实现轻量的动态字段拷贝：

• 可扩展Spring自带的BeanUtils工具类，传入允许的字段列表，仅对指定字段执行get/set赋值即可，实现成本极低。

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