@aws-sdk/lib-dynamodb PutCommand条件表达式嵌套写法咨询

1. PutCommand对嵌套属性条件判断的支持情况 #

完全支持。@aws-sdk/lib-dynamodb提供的Document客户端完整兼容DynamoDB原生ConditionExpression的所有语法规则，不管是PutCommand还是UpdateCommand等写操作，都支持多层嵌套属性、Map类型动态键的条件判断，客户端会自动完成JS原生类型和DynamoDB底层类型描述符（你示例中S/M/NULL这类结构）的转换，不需要手动编写类型标记。

2. 符合业务规则的ConditionExpression写法 #

你的判断场景是Map类型的多层嵌套路径，且中间层的键是动态拼接的（${id}-ARCH-${archNumber}），需要通过表达式属性名做占位，避免动态键包含特殊字符（短横线）触发语法错误，再通过attribute_type函数判断对应字段为NULL类型即可。

基础写法（严格匹配你给出的规则：仅当目标ARCH节点存在，且ata、atd均为NULL值时允许更新） #

import { PutCommand } from "@aws-sdk/lib-dynamodb";

// 业务入参
const itemId = "12345678";
const archNumber = 1;
const targetArchKey = `${itemId}-ARCH-${archNumber}`;

const command = new PutCommand({
  TableName: "你的业务表名",
  Item: {
    // 此处填入你要写入的完整项目数据
    id: itemId
    // 其余业务字段...
  },
  ConditionExpression: `
    attribute_type(#legMap.#archKey.#ata, :nullVal) 
    AND attribute_type(#legMap.#archKey.#atd, :nullVal)
  `,
  ExpressionAttributeNames: {
    "#legMap": "legMap",
    "#archKey": targetArchKey,
    "#ata": "ata",
    "#atd": "atd"
  },
  ExpressionAttributeValues: {
    ":nullVal": "NULL"
  }
});

扩展兼容写法（如果目标ARCH节点本身不存在时也允许更新） #

如果业务上允许目标ARCH节点尚未创建的场景下执行更新，可以把条件表达式调整为：

ConditionExpression: `
  attribute_not_exists(#legMap.#archKey)
  OR (
    attribute_type(#legMap.#archKey.#ata, :nullVal) 
    AND attribute_type(#legMap.#archKey.#atd, :nullVal)
  )
`

注意事项 #

• 当条件不满足时（即目标节点下的ata/atd已经写入了有效的时间字符串），DynamoDB会抛出ConditionalCheckFailedException，代码中捕获该异常即可做对应业务提示。
• 不要尝试直接在表达式中写= NULL做判断，DynamoDB不支持这种语法，必须通过attribute_type(属性路径, 'NULL')判定NULL类型。

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