为什么DynamoDB用UpdateExpression更新返回500 InternalFailure且卡顿30秒

云上老周

2026-9-30

问题根源

你触发500错误的核心原因是违反了DynamoDB表达式的占位符使用规范：

DynamoDB表达式中，属性名的动态占位符必须使用#作为前缀，在ExpressionAttributeNames中定义
只有值的动态占位符才使用:作为前缀，在ExpressionAttributeValues中定义

你当前代码把动态属性名overrideAttr错误放到了ExpressionAttributeValues中，且在表达式里用了值占位符的前缀:，服务端无法解析该异常语法，才返回内部错误。卡顿30秒是AWS SDK默认对标记为retryable: true的错误自动重试导致的总耗时。

修正方案

你需要调整占位符写法，拆分属性名和值的定义：

修正后的请求参数示例：

{
  "TableName": "AppVersions",
  "Key": { "Environment": "int" },
  "UpdateExpression": "SET Overrides.#overrideAttr = :emptylist",
  "ConditionExpression": "attribute_not_exists(Overrides.#overrideAttr)",
  "ExpressionAttributeNames": {
    "#overrideAttr": "EyeTrackerType"
  },
  "ExpressionAttributeValues": {
    ":emptylist": []
  }
}

修正后的完整函数代码：

export async function addOverride(addOverrideRequest: any) {
    const addListIfNotExists = {
        TableName: addOverrideRequest.table,
        Key: {
            Environment: addOverrideRequest.environment
        },
        UpdateExpression: "SET Overrides.#overrideAttr = :emptylist",
        ConditionExpression: "attribute_not_exists(Overrides.#overrideAttr)",
        ExpressionAttributeNames: {
            "#overrideAttr": addOverrideRequest.overrideField,
        },
        ExpressionAttributeValues: {
            ":emptylist": [],
        },
    }

    try {
        const result = await DOCUMENT_CLIENT.update(addListIfNotExists).promise();
    } catch (error) {
        throw error;
    }
}