ios safari 支持 fetch + readablestream 但存在隐性限制：流读取器可能不可构造、textdecoder 异常、首次 read 即返回 {done: true}；需通过三重运行时探测识别，并采用分层降级策略实现兼容。
识别 iOS Safari 对 Fetch Stream 的真实限制
iOS Safari 并非不支持 fetch + ReadableStream，而是对“流式响应消费”的行为施加了多重隐性约束。这些限制不会抛出语法错误，但会导致 response.body.getReader() 静默失败、read() 返回空值、或整个流提前终止——尤其在较新系统（iOS 16.4+）和特定网络环境（如低数据模式开启时）下更明显。
关键识别方式不是查版本号，而是做三重运行时探测：
-
检查流读取器是否可构造：执行
typeof response.body?.getReader === 'function'，若为false或报TypeError: Illegal invocation，说明 WebKit 已禁用该能力（常见于某些 WKWebView 封装场景或低数据模式激活状态） -
验证解码器可用性：
new TextDecoder('utf-8')在部分 iOS 版本中会抛错或返回乱码，需搭配response.headers.get('content-type')?.includes('event-stream')双重确认 -
监听底层连接状态：iOS Safari 对
response.body的底层流可能在首次read()后立即关闭，表现为{done: true, value: undefined}而无任何数据。此时应捕获该信号，而非等待超时
生产级兼容垫片的核心设计原则
垫片不是简单 fallback 到 EventSource，而是按能力分层路由：能流则流，不能流则切片，切片不可靠则退为完整响应解析。所有路径必须共用统一的错误归因与重试策略。
Plan Dubai Travel — Flights, Hotels, Burj Khalifa, Desert Safari, Malls & Itineraries
下载
规划您的迪拜之旅 — 哈利法塔观景、沙漠探险、迪拜购物中心购物、棕榈岛度假村及黄金市场砍价。还提供支持...
-
自动降级检测模块：封装
detectStreamSupport()，内部执行最小化 fetch 流探针请求（如 GET /health?stream=1），500ms 内未收到首个 data 块即判定流不可用 -
双协议适配器：同一业务接口同时支持
text/event-stream和普通application/json响应。服务端通过请求头X-Prefer-Streaming: true或 query 参数识别客户端意图，避免前端硬编码判断 -
内存安全缓冲层：iOS Safari 中
TextDecoder.decode(value, {stream: true})易触发内存抖动。垫片需内置环形缓冲区，将Uint8Array分块拼接后批量解析，避免高频小 buffer 操作
必须绕开的 iOS Safari 流式陷阱
很多看似合理的写法，在 iOS 上会直接失效：
-
禁止在
async/await链中延迟调用getReader()：例如await fetch().then(r => r.body.getReader())会丢失原始响应上下文，应改为const reader = (await fetch()).body.getReader() -
禁止依赖
response.clone()复用流：iOS Safari 中 clone 后的 body 无法再次 getReader，且原 body 会被标记为已锁定 -
低数据模式（Low Data Mode）会静默拦截流式响应：即使请求发出，response.body 可能为空。可通过
navigator.connection?.saveData === true提前感知，并跳过流式路径
轻量垫片代码结构示意
不引入框架，仅用原生 API 封装：
导出 createStreamClient(url, options)，返回对象含 start()、abort()、on('message', cb)、on('error', cb)；内部自动选择 XHR2 流式监听 / fetch + ReadableStream / SSE / 全量 JSON 四种实现，无需业务层感知。
