MapStruct 1.3.1FINAL静态方法导入未生成致编译失败求助

我之前在搭配Lombok使用MapStruct 1.3.x版本时也碰到过一模一样的问题，给你几个经过验证的解决思路：

1. 手动在@Mapper注解中指定导入类 #

MapStruct 1.3.x版本对表达式中静态类的自动导入支持不完善，你可以直接在@Mapper注解的imports属性里声明需要导入的类，这样生成的代码就会自动添加对应的import语句：

@Mapper(imports = ValueUtil.class)
public interface YourDataMapper {
    @Mapping(target = "value", expression = "java(ValueUtil.getValue(sourceValue))")
    TargetDto convertToDto(SourceEntity source);
}

2. 调整Lombok与MapStruct的编译处理顺序 #

如果是用Maven或Gradle构建，确保Lombok的注解处理器先于MapStruct执行——因为Lombok会修改实体类的字节码（生成getter/setter等），如果MapStruct先处理可能会导致解析异常，同时也会影响表达式中类的导入检测。

以Maven为例，正确的maven-compiler-plugin配置如下：

<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>
            <!-- Lombook处理器在前 -->
            <path>
                <groupId>org.projectlombok</groupId>
                <artifactId>lombok</artifactId>
                <version>1.18.4</version>
            </path>
            <!-- MapStruct处理器在后 -->
            <path>
                <groupId>org.mapstruct</groupId>
                <artifactId>mapstruct-processor</artifactId>
                <version>1.3.1.Final</version>
            </path>
        </annotationProcessorPaths>
    </configuration>
</plugin>

3. 升级MapStruct版本 #

1.3.1.Final确实存在不少已知的兼容性问题，其中就包括静态方法导入的bug。如果项目允许的话，升级到1.4.x及以上版本（比如1.4.2.Final）可以彻底解决这个问题——新版本对表达式中的类检测逻辑做了优化，能自动识别并导入所需的静态类，同时对Lombok的兼容性也更好。

4. 临时方案：使用全限定类名调用静态方法 #

如果以上方案暂时无法实施，你可以在表达式中直接写全限定类名，这样即使没有导入语句也能编译通过：

@Mapping(target = "value", expression = "java(com.yourcompany.util.ValueUtil.getValue(sourceValue))")

不过这种方式会让代码显得冗长，建议优先使用前面的方案。

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