常见问题

linpeilie

下载不到依赖

近期阿里maven源一直没有同步最新的依赖包，建议换成腾讯maven源，参考使用腾讯云镜像源加速mavenopen in new window
1.3.3 腾讯源同步的jar包是错误的，升级为最新版本

生成的转换接口与转换类在哪里查看

在编译后的 target/generated-sources 目录下，如果没有该目录，则需要配置 IDEA 展示排除的文件（Show Excluded Files）

"cannot find converter from xxx to xxx" / 没有生成转换接口

建议按照快速开始重新查看一下自己的依赖和配置是否齐全，如果项目中使用了 Lombok，则按照指南-常见问题#与Lombok整合来进行配置；
重新加载 Maven 依赖（Reload All Maven Projects）
mvn clean compile
在 /target/generated-sources 目录下，查看是否生成转换接口。
如果没有生成，联系作者
如果已经生成，需要确认 SpringBoot 能否扫描到生成接口所在的包！
检测是否依赖 spring-boot-devtools，该工具会修改类的 ClassLoader！导致匹配类失败，不止该框架，该工具还会引发其他莫名奇妙的问题！去掉该依赖即可。

生成的转换接口及实现类的目录规则

默认情况下，会在生成在源类同包名下，可以通过配置来指定具体的目录。

需要注意，如果是外部依赖包，也会生成在外部依赖类所在的同名包下，导致 Spring 扫描不到，这种情况下，建议指定具体的目录。

"Couldn't retrieve @Mapper annotation" 异常

该异常是因为 MapStruct 依赖冲突导致的，由于 MapStructPlus 中已经依赖了 MapStruct，所以在使用时无需再添加 MapStruct 的依赖。同时，建议其它依赖中的 MapStruct，也建议排除掉，比如 springfox-swagger2 中就依赖了 MapStruct。

排除完依赖后，重新执行 clean compile

"NoSuchMethodError: …… io.github.linpeilie.ConvertMapperAdapter.xxxMethod" 异常

当所有转换类都能正常生成，在执行时，抛出 NoSuchMethodError 异常，但看生成的代码中，ConvertMapperAdapter 类中是存在该方法的。

当出现该异常时，是因为存在多个模块，且模块之间存在依赖关系，每个模块中，都有需要转换的类，故在生成时，每个模块中，都生成了 io.github.linpeilie.ConvertMapperAdapter 这个类，由于类加载器在加载类时，同名同包的类，只会加载一个，所以在具体执行的时候，实际上调用的不是我们想要的那个类。故出现 NoSuchMethod 异常。

解决方案：为每个模块中添加 MapStructPlus 的配置类，每个模块中指定 adapterPackage 包不同的路径。

与 `lombok` 整合

与 Mapstruct 整合 lombok 的方式一致。

lombok 1.18.16 之前：


<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.8.1</version>
            <configuration>
                <source>1.8</source>
                <target>1.8</target>
                <annotationProcessorPaths>
                    <path>
                        <groupId>org.projectlombok</groupId>
                        <artifactId>lombok</artifactId>
                        <version>${lombok.version}</version>
                    </path>
                    <path>
                        <groupId>io.github.linpeilie</groupId>
                        <artifactId>mapstruct-plus-processor</artifactId>
                        <version>${mapstruct-plus.version}</version>
                    </path>
                </annotationProcessorPaths>
            </configuration>
        </plugin>
    </plugins>
</build>

dependencies {
    annotationProcessor group: 'org.projectlombok', name: 'lombok', version: {lombok.version}
    annotationProcessor group: 'io.github.linpeilie', name: 'mapstruct-plus-processor', version: ${mapstruct-plus.version}
}

lombok 1.18.16 及以后：


<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.8.1</version>
            <configuration>
                <source>1.8</source>
                <target>1.8</target>
                <annotationProcessorPaths>
                    <path>
                        <groupId>org.projectlombok</groupId>
                        <artifactId>lombok</artifactId>
                        <version>${lombok.version}</version>
                    </path>
                    <path>
                        <groupId>io.github.linpeilie</groupId>
                        <artifactId>mapstruct-plus-processor</artifactId>
                        <version>${mapstruct-plus.version}</version>
                    </path>
                    <path>
                        <groupId>org.projectlombok</groupId>
                        <artifactId>lombok-mapstruct-binding</artifactId>
                        <version>0.2.0</version>
                    </path>
                </annotationProcessorPaths>
            </configuration>
        </plugin>
    </plugins>
</build>

dependencies {
    annotationProcessor group: 'org.projectlombok', name: 'lombok', version: {lombok.version}
    annotationProcessor group: 'io.github.linpeilie', name: 'mapstruct-plus-processor', version: ${mapstruct-plus.version}
    annotationProcessor group: 'org.projectlombok', name: 'lombok-mapstruct-binding', version: '0.2.0'
}

本地开发时，修改类后启动报错，mvn clean compile 后又恢复正常

该问题是由于 IDEA 部分编译导致没有找到配置类导致的，先更新最新版本，更换配置方式，详情可以查看指南 - 配置