Go使用AWS SDK v2调用S3 HeadObject报undefined错误排查

执行代码抛出undefined: s3.HeadObject错误的核心原因是AWS SDK for Go v2 不存在包级的s3.HeadObject函数，所有S3服务的API操作方法都绑定在你初始化得到的*s3.Client实例上，当前调用写法不符合v2版本SDK的调用规范。

代码中报错行的调用逻辑存在3个明显问题：

// 错误写法
result, err := &s3.HeadObject(client, input)

• 错误从s3包直接调用HeadObject，该方法不属于包级方法
• 缺少SDK v2要求的第一个必传参数context.Context
• 错误对方法调用结果取地址，方法本身会直接返回指针类型结果和错误

将对象遍历部分的代码替换为以下正确写法即可：

for _, obj := range page.Contents {
    input := &s3.HeadObjectInput{
        Bucket: &bucketName,
        Key:    obj.Key,
    }
    
    // 正确写法：调用client实例的HeadObject方法，第一个参数传入context
    result, err := client.HeadObject(context.TODO(), input)
    if err != nil {
        log.Fatalf("get object %s metadata failed, %v", *obj.Key, err)
    }
    // result中可获取对象元数据：ContentLength、ETag、LastModified、ContentType等字段
    fmt.Printf("Object: %s, Size: %d, ETag: %s\n", *obj.Key, result.ContentLength, *result.ETag)
}

• 修复后执行go mod tidy同步拉取完整依赖，避免本地依赖包残缺导致的方法识别异常
• 注意区分AWS SDK Go v1和v2的写法差异：v2版本所有服务操作均为Client实例方法，第一个参数固定要求传入context，不存在v1版本中包级传client的调用形式
• 如果存储桶内对象数量较多，建议为HeadObject调用增加并发控制，避免同步逐个调用导致执行时间过长

内容的提问来源于stack exchange，提问作者Adrián Blázquez