You need to enable JavaScript to run this app. 基于Require.js打包的Aurelia应用引入mediasoup-client报exports is not defined的解决方法
优惠活动
大模型
产品
解决方案
定价
更多

基于Require.js打包的Aurelia应用引入mediasoup-client报exports is not defined的解决方法

基于Require.js的Aurelia+mediasoup-client运行时exports is not defined问题解决方案

根因说明

这个报错和编译构建流程无关,核心兼容差异在于:

  • Webpack内置了CommonJS/ESM模块解析能力,会自动处理exports、export这类语法的格式转换,所以原有项目在Webpack环境下可以正常运行
  • Require.js原生仅支持AMD模块规范,既不识别CommonJS环境下的全局exports/module变量,也无法直接解析现代ESM的export导出语法;而通过npm安装的mediasoup-client,其lib源码目录下的文件混有这两种非AMD格式的语法,加载时就会触发exports is not defined的运行时报错。

具体解决操作

  • 优先替换为预编译的UMD版本产物,这是零业务代码改动、稳定性最高的方案
    打开aurelia_project/aurelia.json的bundler配置段,把mediasoup-client的依赖项从默认指向lib源码目录,调整为指向dist目录下的预编译UMD文件:
    {
      "name": "mediasoup-client",
      "path": "../node_modules/mediasoup-client/dist",
      "main": "mediasoup-client.min.js"
    }
    
    这个dist目录下的文件是官方预编译好的多加载器兼容UMD产物,本身会自动适配Require.js的AMD加载逻辑,完全不存在CommonJS/ESM语法的兼容问题。
  • 给Require.js添加模块shim映射
    在项目入口的requirejs.config配置中,补充mediasoup-client的shim规则,明确模块加载完成后的全局导出对象:
    requirejs.config({
      // 原有项目配置项全部保留
      shim: {
        'mediasoup-client': {
          exports: 'mediasoupClient'
        }
      }
    })
    
  • 修正业务代码的导入路径
    不要直接引用lib目录下的单个js文件(比如触发报错的RtpParameters.js),这类文件都是纯ESM格式的源码,没有经过UMD转换,直接引用必然触发兼容报错。所有对mediasoup-client的导入都统一走包根入口即可,标准写法为:
    import * as mediasoupClient from 'mediasoup-client';
    
    禁止写import * as RtpParameters from 'mediasoup-client/lib/RtpParameters'这类直接指向lib目录单文件的导入路径。
  • 构建验证
    配置调整后执行au build重新打包,启动应用后检查:
    • 控制台无exports is not defined报错
    • 可以正常创建mediasoup Device实例,完成设备探测、生产/消费流的全流程功能

内容的提问来源于stack exchange,提问作者Luka

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.24 17:15:00