Maven JAXB插件首次构建报‘无法创建目录’错误的解决问询

这是一个典型的Maven生命周期与插件目录操作的冲突问题，结合你描述的现象和插件源码细节，原因和解决办法如下：

可能的原因 #

1. 生命周期阶段与目录创建时机冲突
   jaxb2-maven-plugin的xjc目标默认绑定在generate-sources阶段，这个阶段早于Maven自动创建target/classes的compile阶段。当你执行mvn clean compile时，插件会先尝试创建target/classes目录，但Windows文件系统（从路径看你用的是Windows）有时会存在操作延迟或权限检查滞后，导致File.mkdirs()调用返回false，但实际上目录已经被创建完成——这就是为什么报错后目录存在，第二次执行能成功的原因。

2. 插件配置不合理
   如果你的插件配置把生成类的outputDirectory直接设为target/classes，相当于让插件承担了Maven本身的职责。正常来说，XJC生成的源码应该先放到target/generated-sources/jaxb这类目录，再由Maven的编译阶段自动处理到target/classes，这种配置方式更容易引发目录创建的竞争问题。

3. 文件系统锁定或权限限制
   杀毒软件的实时扫描、IDE的自动编译进程，或者系统权限不足，都可能导致target目录被临时锁定，插件第一次创建子目录时失败，第二次因为目录已存在而绕过了创建步骤。

解决办法 #

方案1：调整插件输出目录（推荐） #

把XJC生成的源码放到专门的生成目录，再通过build-helper-maven-plugin把该目录加入源码路径，让Maven负责后续的编译和目录管理：

<build>
    <plugins>
        <!-- JAXB2插件配置 -->
        <plugin>
            <groupId>org.codehaus.mojo</groupId>
            <artifactId>jaxb2-maven-plugin</artifactId>
            <version>2.4</version>
            <executions>
                <execution>
                    <id>xjc-generate</id>
                    <goals>
                        <goal>xjc</goal>
                    </goals>
                    <configuration>
                        <schemaDirectory>${project.basedir}/src/main/resources/schemas</schemaDirectory>
                        <!-- 输出到专门的生成源码目录 -->
                        <outputDirectory>${project.build.directory}/generated-sources/jaxb</outputDirectory>
                        <clearOutputDir>true</clearOutputDir>
                    </configuration>
                </execution>
            </executions>
        </plugin>

        <!-- 把生成的源码目录加入编译路径 -->
        <plugin>
            <groupId>org.codehaus.mojo</groupId>
            <artifactId>build-helper-maven-plugin</artifactId>
            <version>3.3.0</version>
            <executions>
                <execution>
                    <id>add-generated-sources</id>
                    <phase>generate-sources</phase>
                    <goals>
                        <goal>add-source</goal>
                    </goals>
                    <configuration>
                        <sources>
                            <source>${project.build.directory}/generated-sources/jaxb</source>
                        </sources>
                    </configuration>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

方案2：提前创建target/classes目录 #

在插件执行前，通过maven-antrun-plugin手动创建target/classes目录，避免插件和Maven的创建竞争：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-antrun-plugin</artifactId>
    <version>3.1.0</version>
    <executions>
        <execution>
            <id>pre-create-classes-dir</id>
            <phase>initialize</phase>
            <goals>
                <goal>run</goal>
            </goals>
            <configuration>
                <tasks>
                    <!-- 提前创建输出目录 -->
                    <mkdir dir="${project.build.outputDirectory}"/>
                </tasks>
            </configuration>
        </execution>
    </executions>
</plugin>

方案3：排查系统级问题 #

• 关闭可能占用target目录的程序（比如IDE的自动编译、杀毒软件实时保护）；
• 确保运行Maven的用户对项目目录有完整的读写权限；
• 尝试清理本地Maven仓库并重新构建，排除缓存问题。

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