前端流式输出技术：原理与实战指南

这里用 response.body.getReader() 拿到可读流，配合 TextDecoder 把二进制转文本，循环读到 done 为 true 结束。

处理 SSE（Server-Sent Events）

const eventSource = new EventSource('/stream');

eventSource.onmessage = (event) => {
  const data = JSON.parse(event.data);
  appendToDOM(data.content);
};

eventSource.onerror = () => {
  console.error('Stream closed');
};

SSE 适合单向推送，代码更简洁。

三、主流框架示例

React 实现

function StreamComponent() {
  const [content, setContent] = useState('');
  
  useEffect(() => {
    const controller = new AbortController();
    
    fetch('/api/stream', { signal: controller.signal })
      .then(response => {
        const reader = response.body.getReader();
        const decoder = new TextDecoder();
        
        function read() {
          reader.read().then(({ done, value }) => {
            if (done) return;
            setContent(prev => prev + decoder.decode(value));
            read();
          });
        }
        read();
      });
      
    return () => controller.abort();
  }, []);
  
  return <div className="stream-output">{content}</div>;
}

React 里要注意清理副作用，所以用了 AbortController 来取消请求。

Vue 实现

<template>
  <div ref="output"></div>
</template>

<script>
export default {
  mounted() {
    this.initStream();
  },
  methods: {
    async initStream() {
      const response = await fetch('/stream');
      const reader = response.body.getReader();
      
      while (true) {
        const { done, value } = await reader.read();
        if (done) break;
        this.$refs.output.innerHTML += new TextDecoder().decode(value);
      }
    }
  }
}
</script>

Vue 逻辑类似，直接在生命周期里发起请求即可。

四、优化策略

性能优化：防抖渲染

高频更新 DOM 会卡顿，合并更新是个好办法。

let buffer = [];
let renderScheduled = false;

function scheduleRender() {
  if (!renderScheduled) {
    requestAnimationFrame(() => {
      document.getElementById('output').innerHTML += buffer.join('');
      buffer = [];
      renderScheduled = false;
    });
    renderScheduled = true;
  }
}

// 在数据接收时调用
// buffer.push(chunk);
// scheduleRender();

利用 requestAnimationFrame 控制渲染频率。

用户体验与安全

• 加个加载状态指示器。
• 做好错误重试机制。
• XSS 防护：动态内容务必转义，避免脚本注入。
• 流量控制防止内存溢出。

五、实际案例

聊天应用

const ws = new WebSocket('wss://api.example.com/chat');

ws.onmessage = (event) => {
  const message = JSON.parse(event.data);
  const bubble = `
    <div class="token-interpolation">
      <span>${escapeHtml(message.sender)}</span>
      <span>${escapeHtml(message.content)}</span>
    </div>
  `;
  document.querySelector('.chat-box').insertAdjacentHTML('beforeend', bubble);
};

WebSocket 适合双向交互的聊天场景。

实时日志

function processLogChunk(chunk) {
  return chunk
    .replace(/ERROR/g, '<span class="error">ERROR</span>')
    .replace(/WARN/g, '<span class="warn">WARN</span>');
}

对日志关键词做高亮处理，提升可读性。

六、调试与排查

常见问题

• 流提前关闭：检查服务端是否发送了结束标记。
• 中文乱码：确保统一使用 UTF-8 解码。
• 内存泄漏：及时取消订阅事件。

工具推荐

Chrome DevTools 的 Network -> Response 面板能直接看流数据。 本地测试 SSE 可以用 curl：

curl -N http://api.example.com/stream

结语

流式输出把数据消费权交给客户端，既优化资源又提升体验。随着 Web Streams API 支持度变好，开发者可以更灵活地构建实时应用。记得根据场景选 SSE、WebSocket 或 Fetch，同时别忽视内存管理和错误处理。