Maven通过GitLab CI部署构件到AWS S3失败如何正确配置？

错误根因 #

该报错的核心原因是Maven默认没有内置S3协议的仓库传输支持，无法识别s3://开头的仓库地址，找不到对应的传输实现。

方案一：无插件改动最小方案（推荐，无需新增任何Maven插件） #

直接使用AWS CLI完成jar包上传，完全不需要修改现有Maven配置：

• 确保GitLab CI的deploy阶段运行环境已预装AWS CLI，若未预装可在脚本开头添加安装命令，Debian/Ubuntu环境示例：apt update && apt install -y awscli
• 无需额外配置认证，AWS CLI会自动读取你已经在GitLab CI中配置的AWS_ACCESS_KEY_ID、AWS_SECRET_ACCESS_KEY、AWS_DEFAULT_REGION三个环境变量
• 替换原有maven deploy命令，直接用s3 cp命令上传产物，示例：

# 上传单个jar包
aws s3 cp target/<你的项目打包后的jar文件名>.jar s3://<myartifactbucketname>/<自定义存储路径>/
# 如需上传整个target目录下的所有构建产物，添加--recursive参数
aws s3 cp target/ s3://<myartifactbucketname>/<自定义存储路径>/ --recursive

方案二：保留Maven deploy流程的配置方案 #

如果必须使用Maven原生的deploy能力，仅需添加S3传输扩展即可，改动量极小：

1. 在你的pom.xml的build节点下新增S3 wagon扩展配置：

<build>
    <extensions>
        <extension>
            <groupId>com.allogy.maven.wagon</groupId>
            <artifactId>maven-wagon-s3</artifactId>
            <version>1.2.0</version>
        </extension>
    </extensions>
    <!-- 此处保留你原有build节点的其他配置 -->
</build>

2. 检查以下配置项是否正确：

• pom.xml中distributionManagement的仓库id与aws-settings.xml中的server id完全一致，你当前的artifact-s3-repo配置是正确的
• 对应AWS账号拥有目标S3桶的s3:PutObject、s3:ListBucket权限
• S3桶名称、所属区域与配置的AWS_DEFAULT_REGION匹配

配置完成后即可正常运行原有mvn -s ../aws-settings.xml deploy命令完成上传。

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