remirror使用YjsExtension时WebrtcProvider类型不匹配如何解决

数据老陈

2026-9-25

问题根因

这个类型报错是多版本yjs类型冲突导致的：从错误日志可以看到，你的项目根目录node_modules中安装了独立的yjs依赖，同时remirror包自身也内置了另一版本的yjs依赖，两个版本的类型定义不匹配，导致WebrtcProvider关联的yjs类型和YjsExtension要求的YjsRealtimeProvider关联的yjs类型无法兼容。

解决方案

方案1：强制统一yjs版本（推荐）

在package.json中添加版本锁定配置，强制所有依赖使用同一版本的yjs：

如果你使用npm >=8.3.0，添加overrides配置：

{
  "dependencies": {
    // 你原有依赖保持不变
  },
  "overrides": {
    "yjs": "^13.5.22"
  }
}

如果你使用yarn v1，添加resolutions配置：

{
  "dependencies": {
    // 你原有依赖保持不变
  },
  "resolutions": {
    "yjs": "^13.5.22"
  }
}

配置完成后，删除项目的node_modules文件夹、package-lock.json（或yarn.lock）文件，重新执行依赖安装命令即可。

方案2：临时类型断言绕过

如果不想改动依赖版本，可直接对provider做类型断言绕开类型校验：

new YjsExtension({ getProvider: () => provider as unknown as import('remirror/extensions').YjsRealtimeProvider }),
// 简化写法也可直接断言为any：
// new YjsExtension({ getProvider: () => provider as any }),

注意该方案仅跳过类型检查，没有解决本质的版本冲突问题，仅建议临时调试使用。