Maven打包阶段解压XML Schema压缩包时出现空指针异常

我之前也碰到过类似Maven依赖插件解压资源包时的NPE问题，结合你的场景，咱们一步步排查解决：

• 依赖引用不完整：你只提到导入相关资源，但可能没正确关联到xml-schemas-0.0.1-SNAPSHOT-resources.zip，或者Maven没自动识别到这个附加资源包
• 插件配置错误：dependency插件的unpack目标配置可能存在参数缺失、路径错误，导致无法定位到zip包
• SNAPSHOT版本缓存问题：本地M2仓库的SNAPSHOT包可能存在缓存不一致，插件找不到正确的zip文件

1. 确认源项目的资源包发布配置 #

首先检查源项目的pom.xml，是否通过插件生成并发布了-resources.zip包。比如用maven-assembly-plugin的配置示例：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-assembly-plugin</artifactId>
    <version>3.6.0</version>
    <executions>
        <execution>
            <id>resource-assembly</id>
            <phase>package</phase>
            <goals>
                <goal>single</goal>
            </goals>
            <configuration>
                <descriptorRefs>
                    <descriptorRef>jar-with-resources</descriptorRef>
                </descriptorRefs>
                <appendAssemblyId>false</appendAssemblyId>
                <finalName>xml-schemas-${project.version}-resources</finalName>
            </configuration>
        </execution>
    </executions>
</plugin>

如果源项目没配置，本地M2的zip包是手动放入的，Maven依赖插件无法通过坐标自动识别，需要手动指定路径。

2. 修正消费项目的依赖插件配置 #

在你的项目pom.xml里，确保dependency插件的unpack配置正确指向zip包，关键是classifier和type参数：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-dependency-plugin</artifactId>
    <version>3.6.0</version>
    <executions>
        <execution>
            <id>unpack-xml-schemas</id>
            <phase>process-resources</phase>
            <goals>
                <goal>unpack</goal>
            </goals>
            <configuration>
                <artifactItems>
                    <artifactItem>
                        <groupId>com.comp</groupId>
                        <artifactId>xml-schemas</artifactId>
                        <version>0.0.1-SNAPSHOT</version>
                        <classifier>resources</classifier> <!-- 对应zip包名称里的resources后缀 -->
                        <type>zip</type> <!-- 指定资源类型为zip -->
                        <outputDirectory>${project.build.directory}/schemas</outputDirectory>
                        <includes>**/*.xsd</includes> <!-- 只解压需要的Schema文件 -->
                    </artifactItem>
                </artifactItems>
            </configuration>
        </execution>
    </executions>
</plugin>

如果没指定classifier，Maven会默认找jar包，解压时自然会触发空指针异常。

3. 清理SNAPSHOT缓存并重新构建 #

SNAPSHOT版本的包容易出现缓存不一致问题，执行以下命令强制更新依赖：

mvn clean install -U

-U参数会让Maven忽略本地缓存，重新拉取最新的SNAPSHOT包，避免旧缓存导致的文件找不到问题。

4. 检查zip包完整性 #

手动打开~/.m2/repository/com/comp/xml-schemas/0.0.1-SNAPSHOT/xml-schemas-0.0.1-SNAPSHOT-resources.zip，确认里面存在XML Schema文件且包未损坏。如果包为空或损坏，需要重新构建源项目生成正确的zip包。

如果以上方法都不生效，可以直接用maven-resources-plugin手动操作本地zip包：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-resources-plugin</artifactId>
    <version>3.3.1</version>
    <executions>
        <execution>
            <id>copy-local-zip</id>
            <phase>process-resources</phase>
            <goals>
                <goal>copy-resources</goal>
            </goals>
            <configuration>
                <outputDirectory>${project.build.directory}/schemas</outputDirectory>
                <resources>
                    <resource>
                        <directory>~/.m2/repository/com/comp/xml-schemas/0.0.1-SNAPSHOT</directory>
                        <includes>
                            <include>xml-schemas-0.0.1-SNAPSHOT-resources.zip</include>
                        </includes>
                        <filtering>false</filtering>
                    </resource>
                </resources>
            </configuration>
        </execution>
        <execution>
            <id>extract-zip-content</id>
            <phase>process-resources</phase>
            <goals>
                <goal>unpack</goal>
            </goals>
            <configuration>
                <fromFile>${project.build.directory}/schemas/xml-schemas-0.0.1-SNAPSHOT-resources.zip</fromFile>
                <outputDirectory>${project.build.directory}/schemas</outputDirectory>
            </configuration>
        </execution>
    </executions>
</plugin>

这种方式绕开了依赖插件的自动识别逻辑，直接操作本地文件，适合临时解决问题。

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