serverless-offline本地执行DynamoDB删除无报错但记录未删除

调用DynamoDB删除接口全程无错误抛出，但目标记录未被实际删除，接口返回空对象。

在MacBook设备上使用serverless-offline工具本地运行AWS Lambda服务，调用对应接口删除单条用户数据，实现删除逻辑的代码如下：

export const deleteItem = async <T extends BasePersistent>(item: T) => {
  const params: AWS.DynamoDB.DocumentClient.DeleteItemInput = {
    TableName: process.env.AWS_DYNAMODB_TABLE_NAME!,
    Key: {
      PK: item.PK,
      SK: item.SK,
    },
  };
  const rst = await docClient.delete(params).promise();
  return rst;
};

代码执行后返回结果对象rst，直接复制该对象仅能得到空对象{}，逐层检查rst、rst.$response、rst.$response.data、rst.$response.request字段均未发现错误标识，前往AWS控制台核查数据状态，发现待删除的目标记录仍然存在，全程无错误抛出。

问题根因 #

这是serverless-offline本地调试DynamoDB的高频问题，核心诱因通常为两类：

1. 请求端点指向本地实例而非云端
   本地调试时如果没有显式给AWS SDK配置云端连接参数，或是项目中启用了serverless-dynamodb-local插件，SDK会默认将请求发往本地localhost的DynamoDB服务端口，根本没有触达AWS云端的目标表。这种情况下返回空对象是DynamoDB的正常表现：默认配置下DeleteItem操作执行成功就会返回空响应，只有显式配置ReturnValues参数才会返回被删除的条目内容。
2. 传入主键未匹配到目标记录
   如果确认请求已经发往云端DynamoDB，问题基本出在Key参数上：比如主键字段类型不匹配（表中存储为数字类型，代码中传入字符串）、值携带不可见的前后空格/换行、排序键SK传值错误。DynamoDB的DeleteItem操作不会因为找不到匹配主键抛出错误，会直接返回成功响应，表现为无报错但数据未删除。

排查修复步骤 #

按以下顺序排查即可快速定位问题：

• 先确认请求实际发送的端点：初始化DocumentClient后打印docClient.endpoint属性，如果输出为http://localhost:8000这类本地地址，说明请求打到了本地DynamoDB实例。需要在初始化SDK时显式配置正确的区域、AK/SK凭证，或是关闭本地DynamoDB插件的自动端点注入，确保请求发往目标云端区域。
• 给DeleteItem参数增加ReturnValues: 'ALL_OLD'配置后重新调用：如果返回结果中没有Attributes字段，说明传入的PK/SK组合未匹配到任何记录，直接去DynamoDB控制台复制目标条目的准确主键值，核对类型和内容后重新传参；如果返回结果包含Attributes字段，说明删除已经执行成功，控制台看不到数据是因为页面缓存，手动刷新表数据即可看到最新结果。
• 补全异常捕获逻辑：在delete调用外层包裹try/catch块，打印捕获到的完整错误对象，排查是否存在权限缺失（执行角色无目标表的dynamodb:DeleteItem权限）、表名配置错误（环境变量读取错误导致指向其他表）的问题。

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