NullPointerException at org.mapstruct.ap.internal.processor.DefaultVersionInformation.createManifest

飞熊 • 2023年12月10日下午4:22 • 异常处理 • 阅读 333

在我将idea升级到最新版本后，再在项目中使用mapstruct会报空指针。

方法一 – 坚持使用旧版mapstruct

需要在idea的编译选项中加入：-Djps.track.ap.dependencies=false，禁止跟踪注解处理器内部依赖项集合，从而使得IDEA的增量编译语言规则在这部分无效。

如下设置，即可解决问题：

方法二 – 升级mapstruct

https://github.com/mapstruct/mapstruct/issues/2215
更新mapstruct，最低要1.4.1版本：

【core】https://mvnrepository.com/artifact/org.mapstruct/mapstruct/1.4.1.Final
【processor】https://mvnrepository.com/artifact/org.mapstruct/mapstruct-processor/1.4.1.Final

值得注意的是，一定要确保mapstruct和mapstruct-processor都更新到 1.4.1.Final，否则可能不生效。

比如，maven项目中的某些依赖还依赖了旧版mapstruct，需要一个一个找出来并exclusion。（如果觉得很麻烦，推荐直接用方法一）

    <exclusion>
        <groupId>org.mapstruct</groupId>
        <artifactId>mapstruct</artifactId>
    </exclusion>

感兴趣的可以接着看

增量编译

在我们整个项目编译后，修改了部分代码。我们点击idea的编译，并非会把项目所有源代码编译，只会编译修改的部分，可以节约开发者很大一部分时间。这就是idea的增量构建。
缺点也有，我们的源代码.java并不是所有都是独立的，他们直接由互相引用、关联，在修改了部分源代码会引起其他的连锁反应。因此，为了解决这个问题，idea又使用到了wrapper接口（原理：javax.annotation.processing.ProcessingEnvironment）记录processor曾经生成的所有类或资源，对其进行过滤，对所有被影响到的源文件全部重新编译，以保证编译结果的正确性（过于复杂，并非一定有效，也因此我们有时候需要删除整个target重新编译）。

举例：

读者可自行将idea的构建委托给maven，以尝试idea的增量构建的好处。当然偶尔idea会莫名其妙的抽风，此时委托给maven来构建也不失为一个解决方法。

注解处理器

在编译期对注解进行处理的一系列API，注解处理器可以根据任何类型的可见的元素，生成新的源文件/字节码。

问题原因

问题就出现在，mapstruct能处理编译，idea也能处理编译。

就是这次更新IDEA对编译期的优化做了部分改动（俗称feature），导致mapstruct的org.mapstruct.ap.internal.processor.DefaultVersionInformation.getLibraryName在和IDEA构建过程中，在此环境下拿到NULL，并操作空指针了（就是个NPE bug）。