如何将含外键ID的DTO映射到多对一关系？MapStruct赋值失败求助

方案1：添加自定义类型转换方法 #

在ProductMapper中定义Long与Category的双向转换方法，MapStruct会自动识别并调用这些方法完成映射：

@Mapper(componentModel = "spring")
public interface ProductMapper {
    ProductMapper INSTANCE = Mappers.getMapper(ProductMapper.class);

    List<ProductResponseDto> productToDto(List<Product> products);

    @Mapping(source = "categoryId", target = "category")
    Product dtoToProduct(ProductRequestDto product);
    
    ProductResponseDto productToDto(Product product);

    @Mapping(source = "categoryId", target = "category")
    void update(@MappingTarget Product product, ProductRequestDto productDto);

    // 自定义转换：Category -> Long（用于DTO反向映射）
    default Long categoryToId(Category category) {
        return category != null ? category.getId() : null;
    }

    // 自定义转换：Long -> Category（核心映射逻辑）
    default Category idToCategory(Long categoryId) {
        if (categoryId == null) {
            return null;
        }
        Category category = new Category();
        category.setId(categoryId);
        return category;
    }
}

方案2：使用映射表达式直接创建Category实例 #

通过@Mapping的expression属性，在注解中直接实例化Category对象（前提是Category类有接收id的构造器）：

@Mapper(componentModel = "spring")
public interface ProductMapper {
    ProductMapper INSTANCE = Mappers.getMapper(ProductMapper.class);

    List<ProductResponseDto> productToDto(List<Product> products);

    @Mapping(target = "category", expression = "java(new Category(product.getCategoryId()))")
    Product dtoToProduct(ProductRequestDto product);
    
    ProductResponseDto productToDto(Product product);

    @Mapping(target = "category", expression = "java(new Category(productDto.getCategoryId()))")
    void update(@MappingTarget Product product, ProductRequestDto productDto);
}

若Category无对应构造器，可将表达式改为：java(com.yourpackage.Category category = new Category(); category.setId(product.getCategoryId()); category)

方案3：关联完整Category实体（需查询数据库） #

如果需要映射完整的Category对象而非仅ID引用，可在业务层先通过CategoryRepository查询出实体，再传入映射器：

业务层示例 #

@Service
public class ProductService {
    @Autowired
    private CategoryRepository categoryRepository;
    @Autowired
    private ProductMapper productMapper;

    public Product createProduct(ProductRequestDto dto) {
        Category category = categoryRepository.findById(dto.getCategoryId())
                .orElseThrow(() -> new RuntimeException("Category not found"));
        Product product = productMapper.dtoToProduct(dto);
        product.setCategory(category);
        // 后续持久化操作
        return product;
    }
}

关键说明 #

• MapStruct默认无法自动将Long类型的categoryId映射为Category对象，必须显式定义转换规则
• 方案1、2生成的Category仅含ID，属于JPA的实体引用，持久化时会自动关联数据库中对应分类记录
• 若需完整分类数据，优先采用方案3（映射器应保持纯转换逻辑，避免在其中注入Repository操作数据库）

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