Vite 报 stream 被 externalized，Writable 变成 undefined

浏览器先打印 Module "stream" has been externalized for browser compatibility，随后报 Cannot access "stream.Writable" in client code，或 Class extends value undefined is not a constructor or null。这组错误通常说明浏览器代码的某条依赖链进入了 Node.js 的 stream API，实际取得的 Writable 并不是可用的构造函数。

先保存最前面的模块警告及完整调用栈。只有最后一条 class extends 错误时，还可能是其他导出或依赖问题，不能只凭这句 TypeError 就添加 stream 补丁。

找到是谁把 Node 入口带进浏览器

Vite 8.3.4 的浏览器模块规则不会自动为 Node.js 内置模块提供 polyfill。项目开发服务器运行在 Node 上，并不意味着浏览器也能访问 stream、fs 或 Node 的其他 API。

在调用栈和浏览器 Network 中找到实际失败文件，沿着它的 import 回查项目入口、依赖版本及 package exports。库可能同时提供服务器和浏览器入口，子路径导入、别名或版本组合也可能改变解析结果；不要只看包名就断言整个库不支持浏览器。

例如调用某个 SDK 后错误落在 collector、stream 处理器等传递依赖，首先记录实际 SDK 和相关依赖版本。缺少复现和版本信息时，只能确定当前链路尝试访问 Node API，不能确定是哪个特定 SDK 版本的缺陷。

按运行环境选实现

业务操作确实需要 Node stream 时，将对应处理留在服务器，通过受控接口让浏览器调用。服务端仍要检查身份、权限、输入与资源预算；服务器凭据不能因依赖调整而进入客户端包。

如果库公开支持浏览器，按实际版本选它支持的入口、输入类型与操作方式，并核对构建器解析到的文件。浏览器上传数据可涉及 Blob、File 或 Web Streams；这些接口不能未经适配就当作 Node Writable 的完整替代品。

只有确认所需 API 能被兼容层覆盖时，再评估局部 polyfill。检查库实际用到的事件、缓冲、背压、错误和结束行为，以及生产构建输出；一个对象存在 Writable 属性，不等于它实现了依赖所需的完整语义。

不用预构建选项制造不存在的 API

optimizeDeps.include 可以影响开发依赖预构建，不能让浏览器原生拥有 Node stream。它针对的链接 CommonJS 包 default 导出问题与这里的运行环境差异不是同一根因。

同样，给 process 定义一个空对象、给 stream 配置一个空模块，可能让打包步骤走得更远，却让实际运行继续失败。不要批量改依赖文件，或删除锁文件后期待偶然换到一条可用链路。

保留包清单、锁文件、Vite 配置与入口代码后，按选定边界调整。用实际数据检查原操作，覆盖正常完成、空数据、失败及取消；再走正式构建和部署流程，确认浏览器不再加载这条 Node-only 路径，且服务器与浏览器各自处理正确。仅仅控制台不再显示 externalized 警告，不足以证明上传或数据处理已经成功。