调用@azure/storage-blob的uploadStream报scheduler.do is not a function如何修复

云原生阿岚

2026-10-2

报错根因

该报错由@azure/storage-blob的依赖版本不兼容导致：旧版本的@azure/storage-blob依赖RxJS v6的scheduler.do方法，而RxJS v7及以上版本移除了该API，若项目内其他依赖拉高了RxJS版本，就会触发该报错。少数情况下也可能是你传入的流参数格式不符合要求导致。

解决方案

方案1：升级@azure/storage-blob到最新稳定版
官方已经在新版本中修复了RxJS版本兼容问题，直接执行命令更新即可：
```
npm install @azure/storage-blob@latest
```
方案2：固定RxJS版本为6.x分支
如果因项目约束无法更新@azure/storage-blob，可以手动锁定RxJS的兼容版本：
```
npm install rxjs@6.x
```
方案3：更换上传方法适配参数格式
如果你是在浏览器环境上传File/Blob对象，用uploadStream方法的参数校验更容易触发异常，可以换成适配性更高的uploadData方法，示例代码如下：
```
const blockBlobClient = sourceClient.getBlockBlobClient(blobName);
const uploadBlobResponse = await blockBlobClient.uploadData(file, {
  blockSize: 4 * 1024 * 1024,
  concurrency: 20,
  onProgress: (ev) => console.log(ev)
});
```
如果是Node.js环境，需要确认你传入的file是未被消费过的正常可读流，没有被提前关闭或销毁。