Web Worker 中无 window 对象，三方 SDK 若直接依赖 window/document 会报错；需确认其是否支持 Worker 环境，或通过条件判断、globalThis、构建时区分等方式适配。
Web Worker 中没有 window 对象，而很多三方 SDK（如云开发 Web SDK、海康威视播放控件、部分统计或加密库）默认依赖 window 或其子属性（document、localStorage、location 等），直接在 Worker 中引入会立即报错：ReferenceError: window is not defined。这不是 SDK 本身有 bug，而是运行环境不匹配——Worker 是独立线程，只提供 self、postMessage、fetch 等有限 API。
确认 SDK 是否支持 Worker 环境
不是所有 SDK 都设计为可在 Worker 中运行。使用前先查文档或源码：
- 查看是否明确标注 “supports Web Workers” 或 “can be used in service worker”
- 检查初始化逻辑：若代码中直接访问
window.location.hostname、document.createElement或调用new Audio()，基本不可直接使用 - 云开发 Web SDK 的
cloud实例依赖网络请求和鉴权上下文，虽不操作 DOM，但内部可能隐式读取window.origin或依赖全局fetch（Worker 中可用），需实测验证
用 globalThis + 条件判断隔离浏览器专属逻辑
如果 SDK 源码可控（如已打包进项目或使用 ESM 版本），可手动包裹敏感代码，避免执行浏览器独占逻辑：
- 将
window、document相关操作用if (typeof window !== 'undefined')包裹 - 用
globalThis替代硬编码的window，它在 Worker 中指向self，更安全 - 示例修复片段：
const baseUrl = window.location.origin + '/api';
<!-- 改为 -->
const baseUrl = typeof window !== 'undefined'
? window.location.origin + '/api'
: 'https://your-api-domain.com/api';
改用轻量替代方案或纯逻辑模块
Worker 的核心优势是执行纯计算、加解密、数据预处理等无 DOM 任务。与其强行塞入完整 SDK，不如拆分职责：
- 把加密/解密、JSON Schema 校验、大数据过滤等逻辑抽成独立工具函数，确保不依赖任何全局对象
- 用标准 Web Crypto API（
self.crypto.subtle）替代依赖第三方加密库的代码 - 视频流解析、协议解包等可交由 Worker 处理，但播放控制、UI 渲染仍留在主线程，通过
postMessage通信
构建时做环境区分（Vite / Webpack）
利用构建工具能力，在编译阶段剔除 Worker 不需要的代码块：
- Vite 中可通过
define注入常量：define: { __IN_WORKER__: 'true' }，然后在代码中写if (__IN_WORKER__) { ... } - Webpack 使用
DefinePlugin或EnvironmentPlugin达到类似效果 - 对 SDK 进行条件 import：
if (typeof window !== 'undefined') { await import('./sdk-for-browser.js'); }
