MapStruct报错“Can't find related attribute”问题求助

针对你遇到的问题，以下是具体的排查和解决步骤：

1. 确保Mapper接口添加@Mapper注解 #

你的Mapper接口必须标注@Mapper注解（来自org.mapstruct.Mapper），否则MapStruct不会识别该接口并生成实现类。如果是Spring环境，可指定componentModel = "spring"让生成的类被Spring管理：

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

@Mapper(componentModel = "spring") // 非Spring环境可改为"default"
public interface YourMapper {
    @Mapping(source = "childSeat.id", target = "childSeatId")
    @Mapping(source = "childSeatCol.id", target = "childSeatColId")
    @Mapping(source = "dummyCollision.id", target = "dummyCollisionId")
    ListeDePositionsUniquesDto toDTO(ChildSeat childSeat, ChildSeatCol childSeatCol, DummyCollision dummyCollision);
}

2. 验证DTO类的属性定义 #

确认ListeDePositionsUniquesDto类中存在对应的目标属性，且有可访问的setter方法（可通过Lombok的@Data/@Setter注解自动生成）：

import lombok.Data;

@Data
public class ListeDePositionsUniquesDto {
    private Long childSeatId;
    private Long childSeatColId;
    private Long dummyCollisionId;
    // 其他业务属性...
}

3. 配置编译时保留参数名（Java 8 必备） #

MapStruct需要获取方法参数名称来解析source = "childSeat.id"这类引用，Java 8 默认不会在编译时保留参数名，需在Maven编译插件中添加-parameters参数：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.8.1</version> <!-- 选择兼容Java 8的版本 -->
            <configuration>
                <source>1.8</source>
                <target>1.8</target>
                <compilerArgs>
                    <arg>-parameters</arg> <!-- 关键参数，保留方法参数名 -->
                </compilerArgs>
                <annotationProcessorPaths>
                    <!-- 你的原有注解处理器配置 -->
                </annotationProcessorPaths>
            </configuration>
        </plugin>
    </plugins>
</build>

4. 检查IDEA注解处理器配置 #

• 打开IDEA设置：File > Settings > Build, Execution, Deployment > Compiler > Annotation Processors
• 勾选「Enable annotation processing」
• 确认MapStruct和Lombok的注解处理器被IDEA正确识别

5. 清理缓存并重新编译 #

IDEA的缓存可能导致注解处理器未生效，执行以下操作：

• 点击File > Invalidate Caches...，选择「Invalidate and Restart」重启IDEA
• 重启后执行mvn clean compile重新编译项目

6. 确认版本兼容性 #

Java 8环境推荐的兼容版本组合：

• MapStruct: 1.4.2.Final（最高支持Java 8的稳定版）
• Lombok: 1.18.20（与lombok-mapstruct-binding 0.2.0兼容）
  版本不匹配可能引发注解处理器冲突，导致映射无法正确解析。

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