当 DynamoDB 中目标嵌套映射（如 received）尚未存在时，直接使用 #received.#type 路径进行 SET 操作会触发 ValidationException；根本解决方法是确保父级映射已初始化，或通过条件化表达式安全创建。
当 dynamodb 中目标嵌套映射（如 `received`）尚未存在时，直接使用 `#received.#type` 路径进行 `set` 操作会触发 `validationexception`；根本解决方法是确保父级映射已初始化，或通过条件化表达式安全创建。
在使用 DynamoDB 的 UpdateItem 操作向嵌套结构（例如 received.books）追加元素时，一个常见却容易被忽略的陷阱是：路径中的中间层级（如 received）必须已存在。你当前的更新表达式：
"SET #received.#type = list_append(if_not_exists(#received.#type, :emptyList), :newHomework)"
虽然 if_not_exists() 正确处理了叶子字段 #received.#type（即 received.books）的默认值，但它无法自动创建其父级映射 #received（即 received 对象）。DynamoDB 要求路径中除最末端外的所有中间节点均为有效 Map 类型——若 received 字段根本不存在（NULL 或未定义），访问 #received.#type 即视为非法路径，从而抛出 ValidationException: The document path provided in the update expression is invalid for update。
✅ 正确做法有以下两种（推荐后者以提升健壮性）：
方案一：预初始化父级映射（适用于新建项场景）
在首次创建用户项时，显式初始化 received 为空对象：
// 创建新用户项时（PutItem）
const newItem = {
userId: { S: userId.toString() },
received: { M: {} }, // ← 关键：确保 received 是一个空 Map
// 其他属性...
};
方案二：原子化安全初始化（推荐，适用于任意状态）
利用 if_not_exists() 同时保障 received 和 received.books 的存在性，分两步更新（DynamoDB 支持单次请求中多个 SET 子句）：
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(path, value) 仅对路径末端字段生效，不会递归创建缺失的中间层级；
- 不要尝试用 "SET #received.#type = :value" 直接写入不存在的 received，这将立即失败；
- 若业务允许，也可改用 UpdateItem 的 ADD 操作（仅适用于 Number/Set），但对 List/Map 追加不适用；
- 建议在日志中打印 params 后检查 Key 对应项是否存在 received 字段，便于快速定位数据状态。
通过显式声明 #received = if_not_exists(#received, :emptyMap)，你实现了真正幂等、安全的嵌套列表追加逻辑，彻底规避路径验证异常。
