TypeScript动态导入类时instanceof检查失效问题排查

问题背景 #

开发基于discord.js的TypeScript Discord机器人时，遇到动态导入类的instanceof检查运行时不生效的问题：明明是对应类的实例，instanceof却返回false，但TypeScript编译完全正常，无报错。

环境信息 #

• Node.js 20.9.0
• TypeScript 5.2.2

代码结构 #

项目定义了ReadableCommandObject、ReadableEventObject两个基类，Ping等命令类继承自上述基类；通过ObjectFetcher.read方法动态导入类文件并实例化对象。

异常现象 #

• 正常运行时，所有instanceof检查均不匹配，逻辑走到默认分支（输出“Nothing matched”）
• 但在VS Code调试器或开启Node.js --inspect调试时，instanceof检查能正常返回true，逻辑执行正确

已排查操作 #

• 确认动态导入的文件路径正确，类的导出方式无误
• 重新编译TypeScript代码，清理编译产物后重新构建
• 检查编译后的JavaScript代码，确认类的继承和导出逻辑符合预期
• 验证Node.js、TypeScript及discord.js的版本兼容性

最终解决方案 #

放弃使用instanceof进行运行时类型检查，改用TypeScript类型守卫+接口实现类型校验：

1. 为基类定义对应接口（如IReadableCommand、IReadableEvent），包含类的核心属性/方法签名
2. 编写自定义类型守卫函数，通过检查实例是否包含接口定义的关键属性/方法判断类型：

function isReadableCommand(obj: unknown): obj is IReadableCommand {
  return typeof obj === 'object' && obj !== null && 'name' in obj && 'execute' in obj;
}

function isReadableEvent(obj: unknown): obj is IReadableEvent {
  return typeof obj === 'object' && obj !== null && 'eventName' in obj && 'run' in obj;
}

3. 在业务逻辑中使用类型守卫替代instanceof：

const instance = await ObjectFetcher.read('./commands/Ping.ts');
if (isReadableCommand(instance)) {
  // 处理命令逻辑
} else if (isReadableEvent(instance)) {
  // 处理事件逻辑
} else {
  console.log('Nothing matched');
}

此方案彻底解决了运行时类型检查失效的问题，同时保留了TypeScript的类型安全性。

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