DynamoDB UpdateItem遇like关键字触发语法错误的解决问询

在Lambda托管的Express服务器中调用DynamoDB的updateItem接口，更新users表中名为general的嵌套字段（包含gender和about子字段）。当前PATCH请求代码如下：

app.patch("/profile/general", async function (req, res) {
  
  let params; 

  let newGender; 
  let newAbout;

  if (req.body.general){
    if (req.body.general.gender){
      newGender =  req.body.general.gender
    }
    if (req.body.general.about){
      newAbout =  req.body.general.about
    }

    params = {
      TableName: "users",
      Key: {
        'id': { 'S': req.user.sub },
      },
      UpdateExpression: `set general.gender = ${newGender}, general.about = ${newAbout}`, 
      ReturnValues: "ALL_NEW",
    };
  }

  try {
    let newUserObj = await dynamodb.updateItem(params).promise(); 
    console.log("newUserObj: ", newUserObj); 
    res.json({ "newData": newUserObj });
  } catch (err){
    console.log("error: ", err); 
    res.json({ "error": err });
  }
});

当传入的req.body.general.about字符串包含"like"（例如"I like cookies"）时，CloudWatch报错：ValidationException: Invalid UpdateExpression: Syntax error; token: "like"。需要解决这类关键字被误解析的问题，确保字符串内容被当作普通文本处理。

问题根源在于直接将用户输入的字符串拼接进UpdateExpression，DynamoDB会将其中的SQL-like关键字（如like、and、or等）当作语法指令解析，导致语法错误。正确做法是使用**表达式属性值（ExpressionAttributeValues）**来传递动态值，避免直接拼接。

修改后的代码如下：

app.patch("/profile/general", async function (req, res) {
  let params;
  const updateExpressions = [];
  const expressionAttributeValues = {};

  if (req.body.general) {
    // 处理gender字段更新
    if (req.body.general.gender !== undefined) {
      updateExpressions.push("general.gender = :genderVal");
      expressionAttributeValues[":genderVal"] = { S: req.body.general.gender };
    }
    // 处理about字段更新
    if (req.body.general.about !== undefined) {
      updateExpressions.push("general.about = :aboutVal");
      expressionAttributeValues[":aboutVal"] = { S: req.body.general.about };
    }

    if (updateExpressions.length > 0) {
      params = {
        TableName: "users",
        Key: {
          'id': { 'S': req.user.sub },
        },
        UpdateExpression: `set ${updateExpressions.join(", ")}`,
        ExpressionAttributeValues: expressionAttributeValues,
        ReturnValues: "ALL_NEW",
      };
    }
  }

  try {
    if (!params) {
      return res.json({ message: "No valid fields to update" });
    }
    const newUserObj = await dynamodb.updateItem(params).promise();
    console.log("newUserObj: ", newUserObj);
    res.json({ "newData": newUserObj });
  } catch (err) {
    console.log("error: ", err);
    res.json({ "error": err });
  }
});

关键改进点 #

• 用数组updateExpressions收集需要更新的字段表达式，避免直接拼接值
• 用ExpressionAttributeValues定义占位符对应的值，所有用户输入都通过占位符传递，DynamoDB会将其当作普通字符串处理，不会解析关键字
• 增加了空更新的判断，避免无有效字段时调用updateItem
• 使用!== undefined判断字段是否存在，覆盖字段值为null或空字符串的更新场景

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