使用Go AWS SDK操作S3报错：s3.GetObjectInput非类型且包未使用

核心问题：SDK版本混用 #

你遇到的两个错误几乎可以确定是混用了AWS SDK for Go v1和v2导致的：

• v1的包路径是github.com/aws/aws-sdk-go/service/s3，GetObjectInput是该包下的直接类型
• v2的包路径是github.com/aws/aws-sdk-go-v2/service/s3，虽然也有GetObjectInput，但如果你的代码是按照v1示例写的却导入了v2的包，就会出现类型不匹配；反之亦然。

具体排查&修复步骤 #

1. 检查go.mod中的SDK版本
   执行go list -m all | grep aws，查看输出里的AWS模块版本：

   • v1的模块名是github.com/aws/aws-sdk-go
   • v2的模块名是github.com/aws/aws-sdk-go-v2及其子模块
     若同时存在两个版本，删除不需要的模块引用，再执行go mod tidy清理依赖。

2. 统一导入路径

   • 用v1的话，确保导入github.com/aws/aws-sdk-go/service/s3，代码里直接使用&s3.GetObjectInput{}
   • 用v2的话，导入github.com/aws/aws-sdk-go-v2/service/s3，注意v2的API调用需要传入context，且aws.String来自github.com/aws/aws-sdk-go-v2/aws包

3. 解决"包未被使用"的错误
   这个错误是因为代码里没有直接引用导入的s3包的类型/函数。比如用s3manager.Downloader时不需要直接依赖s3包，但如果代码里尝试用s3.GetObjectInput却因版本错误导致识别失败，就会触发这个提示。只要修正版本匹配问题，代码里正确使用s3包的类型，这个错误会自动消失。

代码示例参考 #

AWS SDK v1 正确写法

import (
    "github.com/aws/aws-sdk-go/aws"
    "github.com/aws/aws-sdk-go/aws/session"
    "github.com/aws/aws-sdk-go/service/s3"
    "github.com/aws/aws-sdk-go/service/s3/s3manager"
    "os"
)

func main() {
    sess, err := session.NewSession(&aws.Config{Region: aws.String("us-east-1")})
    if err != nil {
        panic(err)
    }

    downloader := s3manager.NewDownloader(sess)
    file, err := os.Create("target-file.txt")
    if err != nil {
        panic(err)
    }
    defer file.Close()

    _, err = downloader.Download(file, &s3.GetObjectInput{
        Bucket: aws.String("your-bucket-name"),
        Key:    aws.String("your-object-key"),
    })
    if err != nil {
        panic(err)
    }
}

AWS SDK v2 正确写法

import (
    "context"
    "io"
    "os"

    "github.com/aws/aws-sdk-go-v2/aws"
    "github.com/aws/aws-sdk-go-v2/config"
    "github.com/aws/aws-sdk-go-v2/service/s3"
)

func main() {
    cfg, err := config.LoadDefaultConfig(context.TODO(), config.WithRegion("us-east-1"))
    if err != nil {
        panic(err)
    }

    client := s3.NewFromConfig(cfg)
    file, err := os.Create("target-file.txt")
    if err != nil {
        panic(err)
    }
    defer file.Close()

    resp, err := client.GetObject(context.TODO(), &s3.GetObjectInput{
        Bucket: aws.String("your-bucket-name"),
        Key:    aws.String("your-object-key"),
    })
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    _, err = io.Copy(file, resp.Body)
    if err != nil {
        panic(err)
    }
}

4. 清理缓存重试
   如果上述步骤无效，执行go clean -modcache清理模块缓存，再重新执行go mod tidy拉取正确的依赖版本。

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