已安装soap包但导入后为undefined？ts-node-dev运行异常排查

核心原因 #

soap是基于CommonJS规范编写的模块，它通过module.exports暴露全部API，但并未提供ES模块标准的default导出。你的IDE能正常跳转至定义，是因为@types/soap类型定义文件中可能错误声明了存在default导出，导致编译阶段无报错，但运行时默认导入的结果就是undefined。

解决方法 #

将默认导入改为命名空间导入，直接获取整个模块的导出对象：

import * as soap from "soap";

console.log(soap); // 此时会输出soap的完整API对象

额外排查建议 #

• 核对soap与@types/soap的版本兼容性，版本不匹配可能导致类型定义与实际导出结构不符，建议安装对应版本的类型包。
• 尝试更新ts-node-dev至最新版本，旧版本对ES模块与CommonJS模块的交互处理可能存在缺陷。

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