调用dynamoDb.deleteTable时抛出TypeError: 方法不存在报错

你遇到的TypeError: dynamoDb.deleteTable is not a function是AWS DynamoDB SDK使用中最高频的客户端类型混用坑点：

绝大多数场景下，你从./startup/db模块导出的dynamoDb实例，是DynamoDB DocumentClient，而非原生低阶DynamoDB服务客户端。

两者的能力边界有明确划分：

• DocumentClient：SDK专门封装的文档级读写客户端，仅支持表内数据的增删改查、索引查询操作，不提供任何表结构管理类API，调用deleteTable、createTable这类方法自然会触发“方法不存在”的类型错误。
• 原生低阶DynamoDB客户端：直接对接DynamoDB服务接口的基础客户端，才会包含deleteTable、createTable、updateTable这类表级管理方法。

1. 调整db模块的导出逻辑，明确区分两类客户端，不要混用：
   常见的错误导出写法（很多人写启动初始化模块时容易踩的坑）：

   // 错误写法：把文档客户端当成了通用DynamoDB实例导出
   const AWS = require('aws-sdk')
   AWS.config.update({ region: '你的部署区域' })
   // 这是文档客户端，仅适合做业务数据CRUD
   const dynamoDb = new AWS.DynamoDB.DocumentClient()
   const DEVICES_TABLE = 'devices'
   module.exports = { dynamoDb, DEVICES_TABLE }
   

   修正后的导出逻辑，在不破坏原有业务代码兼容的前提下，补充导出原生服务客户端：

   // 正确写法：区分两类客户端的用途
   const AWS = require('aws-sdk')
   AWS.config.update({ region: '你的部署区域' })
   // 文档客户端：保留原来的导出名dynamoDb，业务侧原有数据读写逻辑无需改动
   const docClient = new AWS.DynamoDB.DocumentClient()
   // 原生服务客户端：专门用于表结构管理操作
   const dynamodbService = new AWS.DynamoDB()
   const DEVICES_TABLE = 'devices'
   module.exports = {
     dynamoDb: docClient,
     dynamodbService,
     DEVICES_TABLE
   }
   

2. 修改删表逻辑的调用实例，把dynamoDb替换为导出的原生服务客户端dynamodbService，原有请求参数、回调逻辑完全不需要调整：

   const { dynamodbService, DEVICES_TABLE } = require('./startup/db')
   
   var params = {
       TableName: DEVICES_TABLE
   };
   
   dynamodbService.deleteTable(params, function (err, data) {
       if (err) {
           console.error("Unable to delete table. Error JSON:", JSON.stringify(err, null, 2));
       } else {
           console.log("Deleted table. Table description JSON:", JSON.stringify(data, null, 2));
       }
   });
   

• 不要为了调用deleteTable就把全局的dynamoDb实例从DocumentClient换成原生DynamoDB客户端：两者的入参格式完全不兼容，DocumentClient会自动帮你把JS原生类型转换成DynamoDB要求的属性值格式（比如把字符串包装为{S: "xxx"}、数字包装为{N: "123"}），原生客户端不会做这类自动转换，直接替换会导致所有原有业务读写代码报错。
• 本地开发联调时，记得给原生服务客户端配置和DocumentClient一致的本地endpoint，避免出现“删表操作跑在云端、业务读写跑在本地实例”的配置错位问题。

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