将AWS DynamoDB从v2升级到v3：KeyConditionExpression适配疑问

核心问题：你混淆了Query和GetItem操作 #

你v2代码用的是Query API（依赖KeyConditionExpression），而v3改成了GetItem API（用GetCommand），这是两种完全不同的DynamoDB操作，这也是你疑惑KeyConditionExpression去向的原因。

先明确两个API的本质区别 #

• GetItem：根据完整主键（复合主键场景下是分区键+排序键）直接定位单个数据项，性能最优，不需要条件表达式，直接传入Key参数即可（就是你v3代码里的写法）。
• Query：用于查询分区键匹配的所有数据项，可以通过KeyConditionExpression添加排序键的匹配规则（比如等于、范围匹配等），还能通过ScanIndexForward控制结果排序，返回的是符合条件的一组数据。

你的代码场景分析 #

你v2里的KeyConditionExpression: "#cuse = :cuse AND #entity = :entity"是精确匹配完整主键，这种场景完全可以用GetItem替代Query，效率更高，你现在的v3代码写法是正确的——这时候不需要KeyConditionExpression，因为GetItem直接通过Key参数定位主键，相当于把v2里的ExpressionAttributeValues直接映射成了Key的键值对。

如果要保留Query操作（比如需要返回多个项或排序） #

如果你原本的需求是查询某个cuse下的多个entity项（虽然当前代码只取第一个），或者需要保留ScanIndexForward排序逻辑，那v3里应该用QueryCommand，这时候KeyConditionExpression的写法和v2几乎完全一致，只是调用方式改变：

const getUsoAXIS = async (cuse) => {
    const queryParams = {
        TableName: TABLE_NAME,
        KeyConditionExpression: "#cuse = :cuse AND #entity = :entity",
        ScanIndexForward: false,
        ExpressionAttributeNames: {
            "#cuse": "cuse",
            "#entity": "entity",
        },
        ExpressionAttributeValues: {
            ":cuse": cuse,
            ":entity": "USOAXIS",
        },
    };
    logger.info("Getting dynamo data in (getUsoAXIS) function", { info: { TableName: TABLE_NAME } });
    const dynamodbRecord = await getDynamodbQuery(queryParams);
    if ("Items" in dynamodbRecord && dynamodbRecord.Items.length > 0) {
        const data = dynamodbRecord.Items[0];
        logger.info("Dynamo data obtained");
        return data.data;
    } else {
        return undefined;
    }
};

// Query操作的封装函数
const getDynamodbQuery = async (params) => {
    try {
        logger.info("Query dynamo data");
        const command = new QueryCommand(params);
        const response = await docClient.send(command);
        logger.info("Query dynamo response", { info: { response } });
        return response;
    } catch (error) {
        logger.error("Error querying dynamo", error);
    }
};

KeyConditionExpression在v3里的转换原理 #

DynamoDB v3 SDK采用命令式API，每个操作对应一个Command类，但命令的参数结构和v2的API请求参数完全兼容——也就是说，你v2里写的KeyConditionExpression、ExpressionAttributeNames、ExpressionAttributeValues这些参数，直接放到对应Command（比如QueryCommand）的参数里就行，不需要做格式转换，唯一的变化是调用方式从docClient.query(params)变成了docClient.send(new QueryCommand(params))。

总结：

• 精确查询单个主键项：用GetCommand，传Key参数，无需KeyConditionExpression。
• 查询多个符合条件的项：用QueryCommand，保留v2里的KeyConditionExpression等参数直接传入即可。

内容的提问来源于stack exchange，提问作者Enrique Manzano Velasco