Maven自定义分隔符构件打包与Nexus发布自定义命名实现

架构老林

2026-11-4

问题根因

Maven中配置的<finalName>规则仅作用于本地打包阶段的输出文件命名，控制target目录下生成的构件文件名。而向Nexus发布构件的流程由maven-deploy-plugin独立控制，默认会按照artifactId-version.扩展名的规则定位并上传文件，不会自动复用finalName的自定义命名逻辑，这就是Nexus中存储文件仍为默认命名格式的根本原因。

自定义发布命名的实现配置

可以通过修改maven-deploy-plugin的文件定位规则，直接绑定finalName生成的自定义命名文件，跳过插件默认的文件定位逻辑，实现发布文件与本地打包文件命名一致：

保留原有<finalName>配置，保证本地打包阶段的自定义命名正常生效
在<build><plugins>标签下添加maven-deploy-plugin的自定义配置，核心代码如下：

<build>
    <finalName>${project.artifactId}##${project.version}</finalName>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-deploy-plugin</artifactId>
            <configuration>
                <!-- 直接指定要上传的构件文件路径，对应finalName生成的自定义命名文件 -->
                <file>${project.build.directory}/${project.build.finalName}.${project.packaging}</file>
            </configuration>
        </plugin>
    </plugins>
</build>

配置完成后执行mvn deploy，上传到Nexus的构件就会保持artifact-name##1.0.0-SNAPSHOT.war的自定义命名格式。

关键注意事项

该配置仅修改上传到Nexus的文件本身的文件名，不会改动Maven仓库的标准目录存储结构，不会破坏基于坐标的依赖解析逻辑，其他项目拉取该构件时仍可通过标准的groupId、artifactId、version坐标正常获取。
不要尝试通过修改Maven仓库的全局布局规则来实现命名修改，这类改动会彻底打乱Maven的坐标-路径映射关系，导致依赖解析失败、其他项目无法正常拉取构件的问题。
文件名中的#属于URL特殊字符，在配置前请确认Nexus服务端、后续拉取构件的脚本、Tomcat部署流程对该字符无解析异常，避免出现文件404、部署识别失败的问题。
如果项目配置了同时上传源码包、JavaDoc包等附属构件，需要单独为每类附属构件配置对应的文件路径，否则这类附属构件仍会使用默认命名规则上传。

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