AWS Lambda使用boto3向DynamoDB写入TTL参数报错求助

刚看到你的问题，用Python3写Lambda通过boto3的put_item()给DynamoDB加1个月TTL时遇到报错，转成字符串后不报错但仍无法正常工作，我来帮你一步步排查：

1. 先明确DynamoDB TTL的核心要求 #

DynamoDB的TTL字段必须满足两个关键条件：

• 类型是数字（N类型）：存储的是UTC时区下的秒级Unix时间戳（不是毫秒，也不是字符串）
• 表已开启TTL配置：必须在DynamoDB控制台或通过API给表指定对应的TTL字段名（比如你代码里用的ttl字段）

你提到必须用str()转换才不报错，大概率是因为你用的是boto3的client对象（而非resource），client要求N类型的参数值必须以字符串形式传入（比如{'N': str(1699999999)}），但这只是参数格式要求，最终存储到DynamoDB的还是数字类型——如果这里转成字符串后你把字段设成了S类型（比如{'S': str(ttl)}），那DynamoDB根本不会把它当作TTL字段处理，这是常见坑！

2. 检查TTL时间戳的计算是否正确 #

1个月有效期的计算容易踩两个坑：

• 用了本地时间而非UTC：DynamoDB判断TTL过期用的是UTC时间，如果你用datetime.now()计算，会导致时间偏差，甚至可能写入的是过去的时间（直接被标记为过期）
• 误生成毫秒级时间戳：Python的datetime.timestamp()返回的是秒级浮点数，转成整数就对了；如果用第三方库生成了13位的毫秒时间戳，DynamoDB会认为是几千年后的时间，自然不会过期

正确的1个月TTL时间戳计算示例：

import datetime

# 计算30天后的UTC时间，转成秒级整数时间戳
ttl_timestamp = int((datetime.utcnow() + datetime.timedelta(days=30)).timestamp())

3. 确认put_item的参数格式是否正确 #

根据你用的是boto3 client还是resource，写法有区别：

如果你用的是client： #

必须明确指定字段类型为N，且值是字符串形式的数字：

import boto3

dynamodb_client = boto3.client('dynamodb')
response = dynamodb_client.put_item(
    TableName='YourTable',
    Item={
        'your_primary_key': {'S': 'example_key'},
        'ttl': {'N': str(ttl_timestamp)}  # 这里的str()是为了符合client的参数要求，存储的是数字类型
    }
)

如果你用的是resource： #

可以直接传入整数，resource会自动处理类型转换：

import boto3

dynamodb_resource = boto3.resource('dynamodb')
table = dynamodb_resource.Table('YourTable')
response = table.put_item(
    Item={
        'your_primary_key': 'example_key',
        'ttl': ttl_timestamp  # 直接传整数即可
    }
)

如果你之前转成字符串后把字段设成了{'S': str(ttl)}，那DynamoDB存储的是字符串类型，TTL规则完全不生效，这就是你转了之后仍无法正常工作的原因！

4. 验证DynamoDB表的TTL配置 #

• 登录AWS控制台，找到你的DynamoDB表，进入「管理表」→「TTL」选项卡
• 确认TTL已开启，并且指定的字段名和你代码里的完全一致（比如都是ttl，大小写敏感！）
• 如果没开启，或者字段名不匹配，即使写入了正确的时间戳，数据也不会自动过期

5. 排查剩余可能的问题 #

• 检查时间戳是否为未来时间：如果计算出的TTL时间戳比当前UTC时间小，DynamoDB会把这条数据标记为待删除（可能很快被删除，导致你以为没写入成功）
• 查看Lambda的权限：确保Lambda角色有dynamodb:PutItem权限，并且没有其他IAM策略限制
• 查看CloudWatch日志：Lambda的报错日志会存在CloudWatch里，找到具体的错误信息（比如类型不匹配、权限不足），能更快定位问题

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