当 DynamoDB 的 UpdateExpression 中引用尚未存在的嵌套属性（如 received.books），会因父级 Map 不存在而抛出 ValidationException；需确保路径中所有中间层级（如 received）已初始化为对象。
当 dynamodb 的 `updateexpression` 中引用尚未存在的嵌套属性（如 `received.books`），会因父级 map 不存在而抛出 `validationexception`；需确保路径中所有中间层级（如 `received`）已初始化为对象。
在使用 DynamoDB 的 list_append 操作向嵌套列表追加元素时，路径有效性依赖于完整层级结构的存在性。你当前的表达式：
"SET #received.#type = list_append(if_not_exists(#received.#type, :emptyList), :newHomework)"
逻辑上是正确的——它尝试对 received.books 执行 list_append，并用 if_not_exists 处理列表首次创建场景。但问题在于：if_not_exists 仅适用于叶子节点（如 #received.#type 本身），而 不负责创建其父级 Map（即 #received）。如果 received 属性在项中完全不存在（即既不是 Map，也不是任何类型），DynamoDB 将拒绝解析 #received.#type 这一路径，直接报错：The document path provided in the update expression is invalid for update。
✅ 正确做法是：确保 received 字段在数据写入初期即存在且类型为 Map。推荐两种稳健方案：
方案一：初始化时显式创建空 Map（推荐）
在首次创建用户项（PutItem）时，就包含 received: {}：
const initialItem = {
userId: { S: userId.toString() },
received: { M: {} }, // ← 关键：显式声明 received 为空 Map
// 其他属性...
};
await this.instance.send(new PutItemCommand({
TableName: this.tableName,
Item: initialItem,
}));
此后你的 UpdateExpression 即可安全执行，#received.#type 路径始终有效。
方案二：在 Update 中同步初始化父级（兼容无初始数据场景）
若无法控制首次写入，可在单次 UpdateItem 中同时初始化 received 和设置子字段：
const updateExpression =
"SET #received = if_not_exists(#received, :emptyMap), " +
"#received.#type = list_append(if_not_exists(#received.#type, :emptyList), :newHomework)";
const expressionAttributeNames = {
"#received": "received",
"#type": "books",
};
const expressionAttributeValues = {
":newHomework": { L: [{ M: { homework: { S: assignerId } } }] },
":emptyList": { L: [] },
":emptyMap": { M: {} }, // ← 新增：为空 Map 提供默认值
};
该方式通过 if_not_exists(#received, :emptyMap) 主动兜底创建 received 父级，再执行后续赋值，避免路径校验失败。
⚠️ 注意事项：
- if_not_exists 对路径中任意缺失的中间层级均无效（如 a.b.c 中 a 或 b 缺失都会失败），它只检查目标属性（c）是否存在；
- DynamoDB 不支持自动级联创建嵌套结构，必须显式保障路径可达；
- 建议在应用层统一初始化策略（如用户注册时预置 received），而非每次更新都做防御性判断，以提升性能与可读性。
综上，修复核心在于 让 received 字段“先存在”，再操作其子属性——这是 DynamoDB 文档路径语义的硬性要求。
