自定义Maven Archetype中Dockerfile与.gitignore未复制问题求助

1. 检查archetype-metadata.xml的文件配置 #

Maven Archetype不会自动包含未声明的根目录特殊文件，必须在<fileSets>节点中明确配置这两个文件。示例配置：

<archetype-descriptor name="basic">
  <fileSets>
    <!-- 声明根目录下的特殊文件 -->
    <fileSet filtered="false" encoding="UTF-8">
      <directory></directory> <!-- 空字符串表示生成项目的根目录 -->
      <includes>
        <include>Dockerfile</include>
        <include>.gitignore</include>
      </includes>
    </fileSet>
    <!-- 保留原有源码等文件集配置 -->
    <fileSet filtered="true" encoding="UTF-8">
      <directory>src/main/java</directory>
      <includes>
        <include>**/*.java</include>
      </includes>
    </fileSet>
  </fileSets>
</archetype-descriptor>

注：filtered="false"表示不对文件内容做变量替换（适合Dockerfile、.gitignore这类无需占位符的文件），如果文件中有${xxx}这类需要替换的变量，改为filtered="true"。

2. 确保Archetype打包时包含目标文件 #

Maven默认资源插件可能会忽略.git开头的文件，需要在Archetype的pom.xml中配置maven-resources-plugin强制包含：

<build>
  <plugins>
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-resources-plugin</artifactId>
      <version>3.3.1</version>
      <configuration>
        <includeEmptyDirs>true</includeEmptyDirs>
        <resources>
          <resource>
            <directory>src/main/resources</directory>
            <includes>
              <include>**/*</include>
              <include>**/.gitignore</include>
              <include>**/Dockerfile</include>
            </includes>
            <filtering>true</filtering>
          </resource>
        </resources>
      </configuration>
    </plugin>
  </plugins>
</build>

配置完成后执行mvn clean install重新打包，解压生成的Archetype jar包（如target/xxx-archetype-1.0-SNAPSHOT.jar），确认archetype-resources目录下存在Dockerfile和.gitignore。

3. 清理Maven缓存并重新生成项目 #

Maven会缓存旧的Archetype版本，可能导致新配置不生效：

• 删除本地仓库中对应Archetype的目录（如~/.m2/repository/com/yourgroup/xxx-archetype/）
• 或在生成命令中添加-U参数强制更新：

mvn archetype:generate -B -U -DarchetypeGroupId=你的组ID -DarchetypeArtifactId=你的ArchetypeID -DarchetypeVersion=版本号 -DgroupId=com.example -DartifactId=demo-project

4. 验证文件路径是否正确 #

确认Dockerfile和.gitignore确实放在src/main/resources/archetype-resources的根目录下，而非子文件夹中；若放在子目录，需同步修改archetype-metadata.xml里的<directory>路径。

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