将S3桶作为Maven仓库：API Gateway下载Jar文件问题咨询

我之前在做类似的S3作为Maven仓库+API Gateway代理的方案时，也碰到过Jar文件下载损坏的问题，结合你的场景（带认证Token的GET请求+Lambda授权器验证），可以从这几个核心环节排查修复：

API Gateway默认只会处理有限的二进制类型，Jar文件对应的MIME类型application/java-archive需要手动添加到二进制媒体类型列表：

• 打开API Gateway控制台，找到你的目标API
• 切换到Settings页面，在Binary Media Types区域添加application/java-archive
• 不建议用通配符*/*覆盖所有类型，会影响文本类型接口的正常解析，精准配置更稳妥

API Gateway代理S3时，如果对二进制数据做了Base64编解码，就会导致文件损坏，必须设置内容处理为透传：

• 在API的Integration Request中，找到Content Handling选项，设置为Passthrough
• 同样在Integration Response里，把Content Handling也设为Passthrough，确保S3返回的二进制数据原封不动传递给客户端

Lambda授权器验证Token后，要保证关键响应头（比如Content-Type、Content-Length）能正常传递：

• 在Lambda授权器的返回结果中，通过context字段携带必要的头信息，示例Python代码：

def lambda_handler(event, context):
    # 这里写你的Token验证逻辑
    # 验证通过后返回授权策略
    return {
        "principalId": "authenticated-user",
        "policyDocument": {
            "Version": "2012-10-17",
            "Statement": [
                {
                    "Action": "execute-api:Invoke",
                    "Effect": "Allow",
                    "Resource": event["methodArn"]
                }
            ]
        },
        "context": {
            "contentType": "application/java-archive"
        }
    }

• 然后在API Gateway的Integration Response中，添加响应头映射：把context.contentType映射到Content-Type，确保客户端收到正确的类型标识

确认S3桶中Jar文件的Content-Type元数据是否正确：

• 进入S3控制台，找到对应的Jar文件，查看Properties -> Metadata
• 如果Content-Type是binary/octet-stream或其他错误类型，修改为application/java-archive
• 批量修改可以用AWS CLI命令：

aws s3 cp s3://your-maven-bucket/com/your/package/your.jar s3://your-maven-bucket/com/your/package/your.jar --content-type application/java-archive

确保发送GET请求时，Accept头包含application/java-archive，这样API Gateway才会触发二进制处理逻辑：

• 比如Maven配置仓库时，要确保请求头正确携带；测试时可以用curl验证：

curl -H "Authorization: Bearer your-auth-token" -H "Accept: application/java-archive" https://your-api-id.execute-api.your-region.amazonaws.com/your-stage/com/your/package/your.jar -o test.jar

按照上面的步骤逐一排查，基本就能解决Jar文件下载损坏的问题了。

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