Mapstrcut报错No property named “xxx“ exists in source parameter(s)

原创已于 2025-06-24 10:13:56 修改 · 895 阅读

14 ·

CC 4.0 BY-SA版权

文章标签：

#java #spring boot #spring #maven

于 2025-06-17 15:42:59 首次发布

这可能是由于MapStruct在编译时没有看到Lombok生成的getter方法，pom文件里lombook和mapstruct不兼容,需要lombok-mapstruct-binding

在官方的文档里也有相关问题描述

常见问题（FAQ） – MapStruct

解决办法

pom文件改一下

<properties>
<!-- 统一版本管理 -->
<org.mapstruct.version>1.6.3</org.mapstruct.version>
<lombok.version>1.18.30</lombok.version>
<lombok-mapstruct-binding.version>0.2.0</lombok-mapstruct-binding.version>
</properties>

<dependencies>
<!-- 其他依赖... -->

<!-- Lombok依赖 -->
<dependency>
    <groupId>org.projectlombok</groupId>
    <artifactId>lombok</artifactId>
    <version>${lombok.version}</version>
    <scope>provided</scope>  <!-- 关键：设为provided -->
</dependency>

<!-- MapStruct核心库 -->
<dependency>
    <groupId>org.mapstruct</groupId>
    <artifactId>mapstruct</artifactId>
    <version>${org.mapstruct.version}</version>
</dependency>

<!-- 桥接器（关键依赖） -->
<dependency>
    <groupId>org.projectlombok</groupId>
    <artifactId>lombok-mapstruct-binding</artifactId>
    <version>${lombok-mapstruct-binding.version}</version>
    <scope>provided</scope>  <!-- 关键：必须provided -->
</dependency>
</dependencies>

<build>
<plugins>
    <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-compiler-plugin</artifactId>
        <version>3.8.1</version>
        <configuration>
            <source>17</source>
            <target>17</target>

            <!-- 关键：注解处理器执行顺序 -->
            <annotationProcessorPaths>
                <!-- 第1步：Lombok生成getter/setter -->
                <path>
                    <groupId>org.projectlombok</groupId>
                    <artifactId>lombok</artifactId>
                    <version>${lombok.version}</version>
                </path>

                <!-- 第2步：桥接器协调 -->
                <path>
                    <groupId>org.projectlombok</groupId>
                    <artifactId>lombok-mapstruct-binding</artifactId>
                    <version>${lombok-mapstruct-binding.version}</version>
                </path>

                <!-- 第3步：MapStruct生成映射实现 -->
                <path>
                    <groupId>org.mapstruct</groupId>
                    <artifactId>mapstruct-processor</artifactId>
                    <version>${org.mapstruct.version}</version>
                </path>
            </annotationProcessorPaths>
        </configuration>
    </plugin>
</plugins>
</build>

也可以自行对比一下下面链接里的pom文件

mapstruct-examples/mapstruct-lombok/pom.xml at b7041df719da3b9e9c5f6304dcac9d9d7e7938a8 · mapstruct/mapstruct-examples · GitHub