Mvn Deploy无法加载S3凭证：Gradle转Maven部署至S3配置求助

我来帮你搞定这个Maven部署到S3时的凭证加载失败问题！从你的配置来看，distributionManagement的结构是对的，但Maven本身并不原生支持s3://协议，而且凭证的配置也需要对应到位，下面分几个步骤排查和解决：

1. 先引入AWS S3的Maven Wagon扩展 #

Maven要处理S3的URL，必须依赖专门的Wagon扩展。你需要在项目的pom.xml中添加这个扩展配置：

<build>
  <extensions>
    <extension>
      <groupId>org.apache.maven.wagon</groupId>
      <artifactId>wagon-aws</artifactId>
      <version>3.5.4</version> <!-- 建议使用最新稳定版本 -->
    </extension>
  </extensions>
</build>

这个扩展会帮Maven处理S3的通信和凭证逻辑，没有它的话，Maven根本不知道怎么解析s3://开头的仓库地址。

2. 配置AWS凭证到Maven的settings.xml #

你在distributionManagement里定义的仓库id（aws-release和aws-snapshots）需要和settings.xml里的服务器凭证一一对应。打开你的Maven settings文件（通常在~/.m2/settings.xml或conf/settings.xml），添加如下配置：

<servers>
  <server>
    <id>aws-release</id>
    <username>你的AWS_ACCESS_KEY_ID</username>
    <password>你的AWS_SECRET_ACCESS_KEY</password>
    <!-- 如果用临时凭证，还需要加下面这行 -->
    <!-- <privateKey>你的AWS_SESSION_TOKEN</privateKey> -->
  </server>
  <server>
    <id>aws-snapshots</id>
    <username>你的AWS_ACCESS_KEY_ID</username>
    <password>你的AWS_SECRET_ACCESS_KEY</password>
    <!-- 临时凭证同理 -->
    <!-- <privateKey>你的AWS_SESSION_TOKEN</privateKey> -->
  </server>
</servers>

注意：这里的id必须和你pom.xml里仓库的id完全一致，Maven就是通过这个id来匹配凭证的。

3. 或者使用AWS默认凭证链（推荐） #

如果你不想在settings.xml里明文写密钥，可以利用AWS的默认凭证链，Maven的wagon-aws会自动识别：

• 环境变量：设置AWS_ACCESS_KEY_ID和AWS_SECRET_ACCESS_KEY两个环境变量
• 本地凭证文件：在~/.aws/credentials里配置默认profile：

  [default]
  aws_access_key_id = 你的密钥ID
  aws_secret_access_key = 你的密钥
  

• IAM角色：如果你的部署机器是AWS EC2/EKS/ECS等资源，可以给实例/容器绑定具有S3权限的IAM角色，这样不需要手动配置任何凭证，Maven会自动获取角色临时凭证

如果用自定义的AWS profile，也可以在settings.xml里指定：

<server>
  <id>aws-release</id>
  <configuration>
    <awsProfile>你的自定义profile名称</awsProfile>
  </configuration>
</server>

4. 检查IAM用户/角色的S3权限 #

不管用哪种凭证方式，对应的IAM实体必须有足够的S3权限来部署包。至少需要以下权限：

• s3:ListBucket：列出仓库目录
• s3:PutObject：上传Jar包
• s3:GetObject：（可选）验证上传的文件
• s3:DeleteObject：（可选）删除错误的包

给IAM用户/角色附加类似这样的政策：

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "s3:ListBucket",
        "s3:PutObject",
        "s3:GetObject"
      ],
      "Resource": [
        "arn:aws:s3:::projectx-support/maven2/release",
        "arn:aws:s3:::projectx-support/maven2/release/*",
        "arn:aws:s3:::projectx-support/maven2/snapshot",
        "arn:aws:s3:::projectx-support/maven2/snapshot/*"
      ]
    }
  ]
}

替换成你实际的S3路径。

5. 测试凭证和权限是否正常 #

在执行mvn deploy之前，可以先用AWS CLI测试一下：

# 列出仓库目录，看是否能访问
aws s3 ls s3://projectx-support/maven2/release/
# 上传一个测试文件，验证权限
echo "test" > test.txt
aws s3 cp test.txt s3://projectx-support/maven2/release/test.txt
aws s3 rm s3://projectx-support/maven2/release/test.txt

如果这些命令能正常执行，说明凭证和权限没问题，问题大概率出在Maven的配置上。

按上面的步骤排查后，再执行mvn deploy应该就能成功加载凭证并部署到S3了！

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