初始化DynamoDB遇TypeError：无法读取undefined的DocumentClient属性

错误分析 #

你遇到的TypeError: Cannot read properties of undefined (reading 'DocumentClient')，本质是全局作用域下XRay对AWS SDK的包装未同步完成，导致初始化AWS.DynamoDB.DocumentClient时，AWS.DynamoDB还处于未定义状态。而将初始化代码移到函数内部时，函数执行是在运行阶段，此时XRay已经完成了对SDK的包装，所以能正常访问DocumentClient。

可行解决方案 #

方案1：单独捕获DynamoDB客户端 #

先初始化DynamoDB DocumentClient，再用XRay捕获其底层服务对象，避开全局初始化时机问题：

const AWS = require('aws-sdk');
const AWSXRay = require('aws-xray-sdk');

// 先初始化客户端
const dynamoDB = new AWS.DynamoDB.DocumentClient();
// 让XRay捕获该客户端的服务实例
AWSXRay.captureAWSClient(dynamoDB.service);

方案2：延迟客户端初始化到函数内部 #

这是你已经验证有效的方式，虽然每次函数调用会触发初始化，但在Lambda等无服务器环境中，冷启动后的容器会复用客户端实例，性能影响可以忽略：

const AWSXRay = require('aws-xray-sdk');
const AWS = AWSXRay.captureAWS(require('aws-sdk'));

function yourHandler(event) {
  // 在函数内部初始化客户端
  const dynamoDB = new AWS.DynamoDB.DocumentClient();
  // 后续使用dynamoDB操作数据库
  return dynamoDB.get({/* 参数 */}).promise();
}

方案3：调整XRay捕获顺序 #

先加载AWS SDK，再让XRay捕获整个SDK，确保包装完成后再初始化客户端：

const AWS = require('aws-sdk');
const AWSXRay = require('aws-xray-sdk');

// 先让XRay完成对SDK的捕获
AWSXRay.captureAWS(AWS);
// 再初始化DocumentClient
const dynamoDB = new AWS.DynamoDB.DocumentClient();

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