如何修复Python Lambda写入DynamoDB时的参数验证错误

你遇到的这个参数验证错误其实是个很常见的boto3使用误区——你用了boto3的低级客户端（client）来调用put_item，但没有按照DynamoDB要求的类型格式构造Item数据。

问题根源 #

从错误日志里的核心提示就能找到问题：

Invalid type for parameter Item.key1, value: value1, type: <class 'int'>, valid types: <class 'dict'>

DynamoDB的低级客户端（boto3.client('dynamodb')）要求每个属性值都必须是一个包含类型标识的字典，比如字符串类型要用{'S': '你的字符串'}，数字类型要用{'N': '123'}（注意数字要转成字符串格式）。而你直接传入了Python原生的字符串、整数，自然会触发参数验证失败。

另外你代码里同时初始化了client和resource，但只用到了client，其实resource是更易用的高级抽象，支持直接传入原生类型。

两种解决方案 #

方案1：修正低级客户端的Item格式

如果你坚持要用client，需要把每个属性值改成DynamoDB要求的类型字典：

import json
import boto3

def lambda_handler(event, context):
    client = boto3.client('dynamodb', region_name='ap-northeast-2')
    response = client.put_item(
        TableName='tablename',
        Item = {
            'key1': {'N': 'value1'},  # 数字类型需转为字符串格式
            'key2': {'S': 'value2'},  # 字符串类型用S标识
            'key3': {'S': 'value3'},
            'key4': {'N': 'value4'}
        }
    )
    return {
        'statusCode': 200,
        'body': json.dumps('Item added successfully!')
    }

方案2：改用高级资源（resource）更简洁

推荐用boto3.resource，它会自动帮你处理类型转换，直接用Python原生类型即可，代码更简洁易读：

import json
import boto3

def lambda_handler(event, context):
    dynamodb = boto3.resource('dynamodb', region_name='ap-northeast-2')
    table = dynamodb.Table('tablename')
    response = table.put_item(
        Item = {
            'key1': value1,  # 直接传入整数
            'key2': 'value2', # 直接传入字符串
            'key3': 'value3',
            'key4': value4
        }
    )
    return {
        'statusCode': 200,
        'body': json.dumps('Item added successfully!')
    }

额外说明 #

升级pip或AWS CLI解决不了这个问题，因为这不是依赖版本的问题，而是API使用方式的错误。低级客户端和高级资源的API格式差异很大，记住：

• boto3.client：严格遵循DynamoDB原生API格式，需要手动指定类型字典
• boto3.resource：更贴近Python开发习惯，自动处理类型映射，开发效率更高

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