使用map-id时Dozer映射异常，如何实现接口差异化字段映射？

当然可以用map-id解决这个问题，这其实是Dozer设计中针对不同场景下差异化映射的典型用法。你遇到的嵌套数组未映射、列表接口丢失price字段的问题，大概率是映射配置的细节没处理到位。下面我一步步帮你梳理具体实现，同时也会给出替代方案供你选择。

一、用map-id实现的详细步骤 #

1. 定义差异化的映射配置 #

假设你的源实体是ProductEntity，目标DTO是ProductDTO，我们需要在Dozer配置中定义两个map-id，分别对应列表接口和详情接口的映射规则：

方式1：XML配置（推荐，灵活性更高）

<mappings xmlns="http://dozer.sourceforge.net"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://dozer.sourceforge.net
          http://dozer.sourceforge.net/schema/beanmapping.xsd">

    <!-- 列表接口专用：仅映射根字段（id/name/price），不包含嵌套字段 -->
    <mapping map-id="product-list">
        <class-a>com.yourpackage.ProductEntity</class-a>
        <class-b>com.yourpackage.ProductDTO</class-b>
        <field>
            <a>id</a>
            <b>id</b>
        </field>
        <field>
            <a>productName</a> <!-- 假设源字段是productName，目标是name -->
            <b>name</b>
        </field>
        <field>
            <a>price</a>
            <b>price</b>
        </field>
        <!-- 此处不配置嵌套字段，Dozer会自动忽略 -->
    </mapping>

    <!-- 详情接口专用：映射所有字段，包括嵌套数组 -->
    <mapping map-id="product-detail" wildcard="true">
        <class-a>com.yourpackage.ProductEntity</class-a>
        <class-b>com.yourpackage.ProductDTO</class-b>
        <!-- wildcard="true"会自动映射所有同名字段，不同名字段单独配置 -->
        <field>
            <a>skuList</a> <!-- 源嵌套数组字段 -->
            <b>skus</b> <!-- 目标DTO的嵌套数组字段 -->
        </field>
        <!-- 其他嵌套字段可按需添加配置 -->
    </mapping>
</mappings>

方式2：注解配置（适合轻量场景）

如果你的项目偏好注解而非XML，可以直接在DTO类上通过@Mapping指定mapId：

@Getter
@Setter
public class ProductDTO {
    private Long id;
    private String name;
    private BigDecimal price;
    private List<SkuDTO> skus;

    // 列表接口映射规则：仅根字段
    @Mapping(source = "productName", target = "name", mapId = "product-list")
    @Mapping(source = "price", target = "price", mapId = "product-list")
    public ProductDTO() {}

    // 详情接口映射规则：包含所有字段
    @Mapping(source = "productName", target = "name", mapId = "product-detail")
    @Mapping(source = "skuList", target = "skus", mapId = "product-detail")
    public ProductDTO() {}
}

2. 在业务代码中指定map-id调用 #

根据不同的接口场景，调用Dozer时传入对应的map-id即可：

列表接口/products

List<ProductEntity> entityList = productRepository.findAll();
// 使用product-list规则映射，仅返回根字段
List<ProductDTO> dtoList = dozerMapper.map(entityList, ProductDTO.class, "product-list");
return dtoList;

详情接口/products/{id}

ProductEntity entity = productRepository.findById(id).orElseThrow(ResourceNotFoundException::new);
// 使用product-detail规则映射，返回全量字段
ProductDTO dto = dozerMapper.map(entity, ProductDTO.class, "product-detail");
return dto;

你之前遇到的问题排查 #

• 嵌套数组未映射：大概率是详情接口的map-id配置中，没有手动指定嵌套字段的映射关系，或者开启wildcard="true"后源与目标字段名不匹配；
• 列表接口丢失price字段：是因为列表的map-id配置中，遗漏了price字段的映射规则，或者源/目标字段名不一致但未手动配置。

二、其他替代解决方案 #

如果觉得map-id的配置有点繁琐，还可以选择以下两种更直观的方案：

1. 定义两个独立的DTO类 #

这是最直观的方案，适合字段差异较大的场景：

// 列表接口专用DTO：仅包含根字段
@Getter
@Setter
public class ProductSimpleDTO {
    private Long id;
    private String name;
    private BigDecimal price;
}

// 详情接口专用DTO：包含全量字段
@Getter
@Setter
public class ProductDetailDTO {
    private Long id;
    private String name;
    private BigDecimal price;
    private List<SkuDTO> skus;
    // 其他嵌套字段...
}

然后在接口中直接映射到对应的DTO：

// 列表接口
List<ProductSimpleDTO> dtoList = dozerMapper.map(entityList, ProductSimpleDTO.class);

// 详情接口
ProductDetailDTO dto = dozerMapper.map(entity, ProductDetailDTO.class);

这种方案的优势是代码可读性强，团队协作时新人更容易理解，不需要维护复杂的映射配置。

2. 动态构建映射规则（BeanMappingBuilder） #

如果需要动态调整映射规则（比如根据请求参数决定返回字段），可以用Dozer的BeanMappingBuilder在代码中动态构建映射：

// 构建列表接口的映射规则：排除嵌套字段
BeanMappingBuilder listMapping = new BeanMappingBuilder() {
    @Override
    protected void configure() {
        mapping(ProductEntity.class, ProductDTO.class)
            .fields("id", "id")
            .fields("productName", "name")
            .fields("price", "price")
            .exclude("skuList"); // 排除嵌套数组
    }
};

// 构建详情接口的映射规则：包含所有字段
BeanMappingBuilder detailMapping = new BeanMappingBuilder() {
    @Override
    protected void configure() {
        mapping(ProductEntity.class, ProductDTO.class)
            .fields("id", "id")
            .fields("productName", "name")
            .fields("price", "price")
            .fields("skuList", "skus");
    }
};

// 将映射规则注册到DozerMapper
dozerMapper.addMapping(listMapping);
dozerMapper.addMapping(detailMapping);

这种方案适合复杂的动态场景，但代码量相对较多，一般推荐在特殊需求下使用。

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