如何强制DynamoDB使用List<String>替代Set<String>存储数据

问题核心是部分AWS SDK会自动将数组推断为String Set类型，要强制存储为List，关键是显式指定字段的数据类型为List，而非依赖SDK的自动推断。以下是主流SDK的实现方式：

Python（boto3） #

使用原生DynamoDB API的类型结构，显式定义L（List）类型：

import boto3

dynamodb = boto3.resource('dynamodb')
table = dynamodb.Table('你的表名')

table.put_item(
    Item={
        'pk': 'test',
        'tests': {
            'L': [{'S': 'a'}, {'S': 'b'}]
        }
    }
)

JavaScript/TypeScript（AWS SDK v3） #

通过PutItemCommand显式指定List类型：

import { DynamoDBClient, PutItemCommand } from "@aws-sdk/client-dynamodb";

const client = new DynamoDBClient({ region: '你的区域' });
const command = new PutItemCommand({
  TableName: '你的表名',
  Item: {
    pk: { S: 'test' },
    tests: { L: [{ S: 'a' }, { S: 'b' }] }
  }
});

await client.send(command);

若使用高层的DynamoDBDocumentClient，默认会将数组转为List；若之前出现自动转Set的情况，需检查是否配置了特殊的类型转换规则。

Java（AWS SDK v2） #

构建AttributeValue时显式指定List类型：

import software.amazon.awssdk.services.dynamodb.DynamoDbClient;
import software.amazon.awssdk.services.dynamodb.model.AttributeValue;
import software.amazon.awssdk.services.dynamodb.model.PutItemRequest;

public class DynamoDBExample {
    public static void main(String[] args) {
        try (DynamoDbClient ddb = DynamoDbClient.create()) {
            PutItemRequest request = PutItemRequest.builder()
                    .tableName("你的表名")
                    .item(
                            "pk", AttributeValue.builder().s("test").build(),
                            "tests", AttributeValue.builder().l(
                                    AttributeValue.builder().s("a").build(),
                                    AttributeValue.builder().s("b").build()
                            ).build()
                    )
                    .build();
            ddb.putItem(request);
        }
    }
}

注意事项 #

• 避免依赖SDK的自动类型推断，显式定义数据类型是最可靠的方式
• 若使用高层封装的DocumentClient类，需确认其类型转换规则是否符合预期

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