请求协助解决Maven Surefire插件契约测试报告文件名过长问题

太懂这种痛点了！契约测试的测试名（尤其是带契约描述、接口路径的那种）加上完整包名，分分钟就撞Unix系统255字符的文件名限制。下面几个实用方案帮你搞定：

方案1：自定义Surefire报告命名格式（最直接高效） #

Surefire其实支持通过reportNameFormat参数自定义报告文件名，不用默认的「全类名+方法名」超长格式。你可以在pom.xml的Surefire插件配置里加上这个参数，用简洁的命名规则：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-surefire-plugin</artifactId>
    <version>你的Surefire版本</version>
    <configuration>
        <!-- 用测试执行序号作为文件名，生成TEST-1.txt、TEST-1.xml这类短文件名 -->
        <reportNameFormat>@{#}</reportNameFormat>
        <!-- 也可以自定义带项目标识的格式，比如： -->
        <!-- <reportNameFormat>${project.artifactId}-test-@{#}</reportNameFormat> -->
    </configuration>
</plugin>

@{#}是Surefire的内置变量，代表测试的执行序号，生成的文件名会非常短。唯一小缺点是需要通过Surefire的控制台日志关联序号和具体测试用例，但契约测试一般在CI环境中运行，日志会完整保留，影响不大。

方案2：用AntRun插件批量重命名报告（更灵活） #

如果不想改变Surefire的默认命名规则，或者需要保留部分测试名信息，可以在测试阶段结束后，用Maven AntRun插件批量处理超长文件名：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-antrun-plugin</artifactId>
    <version>3.1.0</version>
    <executions>
        <execution>
            <phase>test</phase>
            <goals>
                <goal>run</goal>
            </goals>
            <configuration>
                <target>
                    <fileset dir="${project.build.directory}/surefire-reports" includes="*.txt,*.xml">
                        <filename regex="^TEST-.+" />
                    </fileset>
                    <!-- 遍历文件，将长文件名替换为「前缀+短标识+序号」格式 -->
                    <script language="javascript">
                        var files = project.getReferences().get("fileset").getDirectoryScanner(project).getIncludedFiles();
                        for (var i=0; i&lt;files.length; i++) {
                            var oldFile = new java.io.File(project.getProperty("project.build.directory") + "/surefire-reports/" + files[i]);
                            // 保留文件名前50个有效字符+序号+后缀，避免超长
                            var suffix = files[i].substring(files[i].lastIndexOf('.'));
                            var trimmedName = files[i].substring(0, 50).replace(/[^a-zA-Z0-9]/g, '_');
                            var newName = "TEST-" + trimmedName + "-" + i + suffix;
                            var newFile = new java.io.File(project.getProperty("project.build.directory") + "/surefire-reports/" + newName);
                            oldFile.renameTo(newFile);
                        }
                    </script>
                </target>
            </configuration>
        </execution>
    </executions>
</plugin>

这个方案能自定义重命名规则，既避免文件名超长，又能保留部分可识别的测试信息，适合对报告文件名有辨识度要求的场景。

方案3：升级Surefire到最新版本 #

部分较新的Surefire版本（比如3.0.0-M7及以上）对文件名长度做了优化，甚至新增了隐性的短命名支持。虽然官方文档没重点提及，但社区有相关修复记录，升级后可能自动解决问题，不妨先试试。

另外，如果你用的是Pact这类契约测试框架，也可以在生成测试用例时，尽量简化测试方法的名称（比如去掉冗余的接口路径描述），从源头减少文件名长度。

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