Node.js+TypeScript后端访问Amazon DynamoDB凭证无效问题求助

错误分析 #

该错误表明DynamoDB客户端无法验证你提供的AWS凭证，核心原因集中在凭证有效性、配置加载或权限不足上，以下是针对性排查和修复步骤：

1. 验证AWS凭证的有效性 #

• 确认AWS_ACCESS_KEY_ID和AWS_SECRET_ACCESS_KEY无空格、截断或拼写错误，可直接复制AWS控制台生成的完整凭证
• 检查凭证权限：确保该凭证关联的IAM用户拥有DynamoDB读写权限（例如附加AmazonDynamoDBFullAccess策略，或自定义包含dynamodb:Query、dynamodb:PutItem的权限策略）
• 用AWS CLI快速验证：

  aws dynamodb list-tables --region <你的REGION值>
  

  若命令返回正常结果，说明凭证本身有效；若报错，优先解决凭证权限或正确性问题

2. 修复DynamoDB客户端配置 #

避免直接使用非空断言!，添加环境变量校验逻辑，防止未正确加载的变量传入客户端：

// dbconfig.ts
import { DynamoDBClient } from "@aws-sdk/client-dynamodb";

const accessKeyId = process.env.AWS_ACCESS_KEY_ID;
const secretAccessKey = process.env.AWS_SECRET_ACCESS_KEY;
const region = process.env.REGION;

// 提前校验环境变量，避免无效配置传入客户端
if (!accessKeyId || !secretAccessKey || !region) {
  throw new Error("AWS凭证或区域未在环境变量中配置");
}

const ddbClient: DynamoDBClient = new DynamoDBClient({
  region,
  credentials: {
    accessKeyId,
    secretAccessKey,
  },
});

export { ddbClient };

3. 确保环境变量正确加载 #

• 若使用dotenv，必须在项目入口文件（如server.ts/app.ts）最顶部加载：

  // 入口文件第一行
  import 'dotenv/config';
  

• 检查.env文件变量名：确认是AWS_ACCESS_KEY_ID、AWS_SECRET_ACCESS_KEY、REGION，无拼写错误

4. 修复UserController逻辑问题（附带优化） #

当前代码存在混合await与then/catch的逻辑混乱，且未执行实际的用户创建操作，修复后代码：

// UserController.ts
static async register(req: Request, res: Response) {
  try {
    const parsedData: RegisterUserInput = RegisterUserSchema.parse(req.body);
    const { confirm, creditNumber, expireMonth, expireYear, creditCode, creditZip, creditOwner, ...filteredInput } = parsedData;
    const hashedPassword: string = await bcrypt.hash(filteredInput.password, 12);

    // 查询用户是否存在
    const queryParams: QueryCommandInput = {
      TableName: "users",
      KeyConditionExpression: "email = :email",
      ExpressionAttributeValues: {
        ":email": filteredInput.email,
      },
    };
    const existUser = await ddbDocClient.send(new QueryCommand(queryParams));
    
    if (existUser.Items && existUser.Items.length > 0) {
      return res.status(409).json({ // 用409状态码表示资源冲突更规范
        success: false,
        message: "该邮箱已注册",
      });
    }

    // 创建新用户
    const putParams: PutCommandInput = {
      TableName: "users",
      Item: {
        _id: uuidv4(),
        ...filteredInput,
        password: hashedPassword
      }
    };
    const data = await ddbDocClient.send(new PutCommand(putParams));
    
    return res.status(201).json({
      success: true,
      message: "注册成功",
      result: data,
    });
  } catch (error) {
    console.log(error);
    return res.status(500).json({
      success: false,
      message: "服务器内部错误",
      error
    });
  }
}

5. 额外排查点 #

• 本地开发时，检查~/.aws/credentials文件是否存在冲突配置，可在DynamoDB客户端中明确指定凭证以避免读取默认配置
• 确保@aws-sdk/client-dynamodb与@aws-sdk/lib-dynamodb版本一致，版本不兼容可能导致签名验证错误

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