ModelMapper多层级属性映射冲突问题及解决方案咨询

这个错误很典型，原因是你的DocumentToSignRestRequest里包含了SignatureOptions和PdfSignatureOptions两个嵌套对象，它们二者都存在能匹配DocumentDto.setSignatureType()的属性（比如都定义了signatureType字段）。ModelMapper的自动匹配机制在遍历所有源属性层级时，找不到唯一的映射路径，因此抛出了这个歧义错误。

下面是几种可行的解决方案，核心思路都是显式消除映射歧义，和你参考的投影示例逻辑一致：

1. 直接指定单属性映射路径 #

最直观的方式是给ModelMapper明确标注要从哪个嵌套对象的属性映射到目标字段。比如你想使用SignatureOptions里的signatureType：

// 在ModelMapper配置环节添加这个映射规则
modelMapper.addMappings(mapper -> {
    mapper.map(
        source -> source.getSignatureOptions().getSignatureType(),
        DocumentDto::setSignatureType
    );
    // 其他有歧义的字段也可以在这里逐一配置
});

如果需要用PdfSignatureOptions的属性，只需要把getSignatureOptions()替换成getPdfSignatureOptions()即可。

2. 创建TypeMap做精细映射管理 #

如果你的映射规则较多，推荐创建TypeMap来统一管理整个类的映射关系，结构会更清晰：

TypeMap<DocumentToSignRestRequest, DocumentDto> typeMap = 
    modelMapper.createTypeMap(DocumentToSignRestRequest.class, DocumentDto.class);

// 明确指定signatureType的映射来源
typeMap.addMapping(
    DocumentToSignRestRequest::getSignatureOptions,
    (destination, value) -> destination.setSignatureType(((SignatureOptions) value).getSignatureType())
);

这种方式可以批量覆盖所有存在歧义的属性，便于后续维护。

3. 忽略不需要的源属性路径 #

如果你只需要其中一个嵌套对象的相关属性，可以直接忽略另一个对象的所有属性，从根源避免匹配歧义：

modelMapper.addMappings(mapper -> {
    // 忽略PdfSignatureOptions的所有属性，仅使用SignatureOptions的内容
    mapper.skip(DocumentToSignRestRequest::getPdfSignatureOptions);
    // 或者更精准地：只忽略PdfSignatureOptions里的signatureType相关路径
    // mapper.skip((DocumentDto dest) -> dest.setSignatureType());
    // 再手动指定正确的映射
    mapper.map(src -> src.getSignatureOptions().getSignatureType(), DocumentDto::setSignatureType);
});

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