使用Golang连接AWS S3时端点配置缺失问题及端点查询方法

错误提示：Error : Endpoint configuration missing for this service while using aws S3 with Golang

对应代码：

session, err := session.NewSessionWithOptions(
    session.Options{
        Profile: "default",
        Config: aws.Config{
            Credentials:      credentials.NewStaticCredentials("XXXXXXXXXXXXXXXX", "XXXXXXXXXXX", ""),
            Region:           aws.String(AWS_S3_REGION),
            Endpoint:         aws.String("XXXXXXX"), // 问题所在行
            DisableSSL:       aws.Bool(false),
            S3ForcePathStyle: aws.Bool(true),
        },
    },
)

问题 #

使用Golang连接AWS S3时，Endpoint应配置什么值？在哪里可以找到AWS S3的端点？本地使用S3模拟器可正常运行，但连接AWS云端S3时无法正常工作。

解决方法 #

1. 云端AWS S3的正确配置 #

连接官方AWS S3云端服务时，完全不需要手动设置Endpoint参数。AWS Go SDK会根据你指定的Region自动匹配对应的S3端点，手动填写反而会导致配置冲突，这就是你云端连接失败的原因。

直接删除代码中的Endpoint: aws.String("XXXXXXX"),这一行即可，修改后的代码示例：

session, err := session.NewSessionWithOptions(
    session.Options{
        Profile: "default",
        Config: aws.Config{
            Credentials:      credentials.NewStaticCredentials("XXXXXXXXXXXXXXXX", "XXXXXXXXXXX", ""),
            Region:           aws.String(AWS_S3_REGION),
            DisableSSL:       aws.Bool(false),
            S3ForcePathStyle: aws.Bool(true),
        },
    },
)

2. AWS S3端点的获取方式（特殊场景手动指定用） #

如果因特殊需求必须手动指定端点，AWS S3的端点格式为：s3.<区域代码>.amazonaws.com，例如：

• us-east-1区域端点：s3.us-east-1.amazonaws.com
• ap-southeast-1区域端点：s3.ap-southeast-1.amazonaws.com

3. 本地模拟器与云端S3的配置差异 #

• 本地S3模拟器（如MinIO、LocalStack）需要手动指定Endpoint（例如http://localhost:9000），因为SDK无法自动识别这类第三方模拟服务。
• 云端AWS S3则完全依赖Region自动推导端点，无需手动配置。

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