使用Go在DynamoDB中创建条目报错求助（基于aws-sdk-go-v2）

我之前迁移aws-sdk-go到v2时也碰到过一模一样的坑！核心问题大概率不是你结构体字段名的大小写，而是DynamoDB序列化标签的使用错误，结合官方文档的适配细节，给你几个排查方向：

1. 必须使用dynamodbav标签做字段映射 #

aws-sdk-go-v2的DynamoDB客户端依赖dynamodbav（DynamoDB Attribute Value）标签来完成Go结构体和DynamoDB条目之间的序列化，旧版SDK的dynamodb或json标签在v2里不生效。

举个正确的结构体写法示例：

type Record struct {
    // 标签值必须和DynamoDB表的主键名完全一致（包括大小写）
    ID   string `dynamodbav:"ID"`
    Name string `dynamodbav:"Name"`
    // 其他字段同理
}

如果你之前沿用了旧版的标签，哪怕字段名写对了，SDK也无法正确识别映射关系。

2. 严格匹配DynamoDB表的主键大小写 #

DynamoDB是大小写敏感的，比如你的表主键定义的是id（全小写），那结构体标签必须写dynamodbav:"id"，哪怕Go字段名是ID也没关系——标签值才是SDK用来匹配DynamoDB字段的依据，和Go字段名本身的大小写无关。

3. 检查PutItem请求的构造方式 #

确保你用正确的方式序列化结构体到Item：

import (
    "context"
    "github.com/aws/aws-sdk-go-v2/aws"
    "github.com/aws/aws-sdk-go-v2/service/dynamodb"
    "github.com/aws/aws-sdk-go-v2/service/dynamodb/types"
    "github.com/aws/aws-sdk-go-v2/feature/dynamodb/attributevalue"
)

// 正确的序列化方式
record := Record{ID: "user123", Name: "test"}
item, err := attributevalue.MarshalMap(record)
if err != nil {
    panic(err)
}

input := &dynamodb.PutItemInput{
    TableName: aws.String("your-table-name"),
    Item:      item,
}

// 发送请求
client := dynamodb.NewFromConfig(cfg)
_, err = client.PutItem(context.TODO(), input)

如果是手动构造map[string]types.AttributeValue，一定要保证键名和表主键完全一致，比如主键是ID就不能写成id。

4. 开启SDK日志排查请求细节 #

如果还是找不到问题，建议开启SDK的调试日志，直接看发送给DynamoDB的请求体：

cfg, err := config.LoadDefaultConfig(context.TODO(),
    config.WithLogger(logging.NewLogger(logging.LogLevelDebug, os.Stdout)),
    config.WithClientLogMode(aws.LogRequestWithBody|aws.LogResponseWithBody),
)

从日志里能清晰看到请求中的Item字段结构，对比你的表定义就能快速定位不匹配的地方。

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