AWS DynamoDB table.query()查询异常问题求助

1. 检查KeyConditionExpression的正确性 #

DynamoDB的query操作对分区键的匹配语法要求严格，且属性名区分大小写。如果代码里写错了分区键名称（比如把Serial_Number写成小写的serial_number），会直接导致查询不到数据，最终被FastAPI返回404。

正确的写法示例：

from boto3.dynamodb.conditions import Key

response = table.query(
    KeyConditionExpression=Key('Serial_Number').eq('目标序列号')
)

务必确认导入了boto3.dynamodb.conditions.Key，且分区键名称和表定义完全一致。

2. 检查FastAPI的响应逻辑 #

大概率不是DynamoDB查询失败，而是你把空结果集错误映射成了404。比如后端代码可能写了：

from fastapi import HTTPException

@app.get("/device/{serial_number}")
async def get_device_data(serial_number: str):
    response = device_data_manager.query_by_serial(serial_number)
    if not response.get('Items'):
        raise HTTPException(status_code=404, detail="No data found")
    return response['Items']

这种情况下，先打印response的完整内容，确认DynamoDB是否真的返回了空Items——有可能是你传入的serial_number值和控制台查询的不一致（比如多了空格、大小写差异）。

3. 验证DynamoDB客户端的环境配置 #

确认后端代码和控制台操作的是同一个DynamoDB环境：

• 检查AWS区域是否匹配（比如控制台用us-east-1，代码里配成了ap-southeast-1）
• 核对凭证对应的账号是否有权限访问目标表，有没有误操作测试表而非生产表
• 可以在代码中打印table.table_name和table.meta.client._endpoint.host，确认表名和服务端点是否正确

4. 排查Query操作的额外参数 #

检查是否误加了不必要的过滤条件，导致结果被过滤为空。比如：

# 错误示例：添加了不存在的属性过滤条件
response = table.query(
    KeyConditionExpression=Key('Serial_Number').eq('SN123'),
    FilterExpression=Attr('Invalid_Attribute').exists()
)

这种情况会返回空Items，进而触发404。

5. 打印DynamoDB原始响应定位问题 #

在代码中添加日志，打印query操作的完整响应：

response = table.query(
    KeyConditionExpression=Key('Serial_Number').eq(target_serial)
)
print(f"DynamoDB Query Response: {response}")

通过查看Items、Count、ScannedCount字段，直接判断是真的无数据，还是查询逻辑出错。

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