使用DynamoDB持久化JS对象遇undefined错误排查

你遇到的这个错误，核心原因是你的JavaScript对象中确实存在undefined值，但JSON.stringify()会自动忽略这类值，导致你看不到它们。以下是具体的几种场景：

1. 嵌套层级中的undefined
   undefined可能藏在深层嵌套的对象或数组里，比如{ user: { profile: { bio: undefined } } }或者[1, undefined, { id: 2 }]。控制台打印嵌套过深的对象时，未展开的层级会被省略；而JSON.stringify()序列化时会直接跳过undefined属性/元素，所以你无法通过这两种方式发现它们。

2. JSON.stringify的特性限制
   标准JSON格式本身不支持undefined值，JSON.stringify()处理时会：

   • 直接跳过对象中值为undefined的属性
   • 将数组中值为undefined的元素转为null（但原对象里的数组元素依然是undefined，序列化工具会检测到）

3. Getter属性返回undefined
   如果对象的某个属性是getter且返回undefined，比如：

   const data = {
     get hiddenProp() {
       return undefined;
     }
   };
   

   JSON.stringify(data)会输出{}，但实际访问data.hiddenProp得到的是undefined，DynamoDB的序列化工具会检测到这个值。

4. 原型链上的undefined属性
   若你的对象继承自某个原型，原型链上存在值为undefined的属性，部分序列化逻辑可能会遍历原型链（虽然默认情况较少见，但不排除特殊场景），从而触发错误。

可以写一个递归函数遍历对象的所有层级，找出隐藏的undefined值：

function scanForUndefined(obj, currentPath = '') {
  if (obj === null || typeof obj !== 'object') return;

  // 处理对象属性
  if (!Array.isArray(obj)) {
    for (const key of Object.keys(obj)) {
      const fullPath = currentPath ? `${currentPath}.${key}` : key;
      if (obj[key] === undefined) {
        console.log(`找到undefined值：${fullPath}`);
      } else {
        scanForUndefined(obj[key], fullPath);
      }
    }
  } 
  // 处理数组元素
  else {
    obj.forEach((item, index) => {
      const fullPath = currentPath ? `${currentPath}[${index}]` : `[${index}]`;
      if (item === undefined) {
        console.log(`找到undefined值：${fullPath}`);
      } else {
        scanForUndefined(item, fullPath);
      }
    });
  }
}

// 传入你的对象进行扫描
scanForUndefined(yourDynamoDBObject);

如果暂时不需要定位具体的undefined值，可以直接按照错误提示开启removeUndefinedValues选项：

• 使用DynamoDBDocumentClient时：

  const docClient = DynamoDBDocumentClient.from(new DynamoDBClient({}), {
    marshallOptions: {
      removeUndefinedValues: true
    }
  });
  

• 使用marshall工具时：

  const marshalledData = marshall(yourObject, { removeUndefinedValues: true });
  

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