Node.js中mediasoup未定义报错：无法读取createWorker属性

排查与解决步骤 #

• 检查导入语句正确性
  TypeScript环境下，mediasoup的导入需匹配项目模块系统：

  // 默认导入（推荐）
  import mediasoup from 'mediasoup';
  // 或命名导入
  import { createWorker } from 'mediasoup';
  

  若使用CommonJS规范，则用：

  const mediasoup = require('mediasoup');
  

  同时确保tsconfig.json的module配置与导入方式匹配（如ESNext或CommonJS）。

• 重新安装mediasoup
  原生模块编译失败可能导致包不完整，执行以下操作：

  # 删除依赖文件和锁文件
  rm -rf node_modules package-lock.json
  # 清理npm缓存
  npm cache clean --force
  # 以管理员身份运行终端，重新安装
  npm install
  

  安装过程中留意是否有编译报错，若有需确认MSBuild工具、Python 3.10.7已正确配置（Windows环境）。

• 配置TypeScript模块解析
  在tsconfig.json中添加或修改以下配置，确保默认导入生效：

  {
    "compilerOptions": {
      "moduleResolution": "node",
      "allowSyntheticDefaultImports": true
    }
  }
  

• 验证包完整性
  进入项目的node_modules/mediasoup目录，检查是否存在lib文件夹及其中的index.js、index.d.ts文件。若缺失，说明安装未完成，需重复重新安装步骤。

• 确认变量作用域
  确保mediasoup变量在createWorker方法的作用域内可访问，比如是否在类的顶部正确导入，未被误定义为局部变量。

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