使用 EventSource 接收流式文本时，若内容包含 HTML 标签（如 <a> 链接），直接拼接 innerHTML 可能因解析时机问题导致标签未被渲染；需累积完整 HTML 片段后一次性赋值，确保浏览器正确解析 DOM。
使用 eventsource 接收流式文本时，若内容包含 html 标签（如 `` 链接），直接拼接 `innerhtml` 可能因解析时机问题导致标签未被渲染；需累积完整 html 片段后一次性赋值，确保浏览器正确解析 dom。
在流式内容传输场景中（例如通过 Server-Sent Events 实时返回带格式的响应），一个常见误区是：将每段增量 HTML 字符串用 += 直接追加到 element.innerHTML。这看似合理，实则存在严重隐患——浏览器可能在 HTML 标签未闭合（如 <a href="https://www.php.cn/link/263b1243ca2dbeb358777ceabc4a2e4c"> 尚未遇到 </a>）时就尝试解析并渲染，导致标签被当作纯文本或被截断，最终链接无法点击、样式丢失，甚至破坏后续 DOM 结构。
✅ 正确做法是：维护一个 HTML 缓冲区（buffer），每次收到新数据时追加至缓冲区，再整体重写 innerHTML。这样可确保浏览器始终基于语法完整的 HTML 片段进行解析：
const responseDisplay = document.getElementById('response-display');
const eventSource = new EventSource('http://127.0.0.1:8000/do-chat');
let htmlBuffer = ""; // ✅ 关键：统一维护 HTML 状态
eventSource.onmessage = function(event) {
console.log('Received chunk:', event.data);
htmlBuffer += event.data; // 累积原始 HTML 字符串
responseDisplay.innerHTML = htmlBuffer; // ✅ 一次性设置完整 HTML，触发安全解析
};
eventSource.onerror = function(error) {
console.error('EventSource failed:', error);
eventSource.close();
};⚠️ 注意事项：
- 避免使用 textContent += https://www.php.cn/link/263b1243ca2dbeb358777ceabc4a2e4c：它会强制转义所有 HTML 字符（<, > 等变为实体），链接永远无法渲染；
- 不要在流中插入不完整标签：服务端应确保每个 data: 块输出的是语义完整的 HTML 片段（如不拆分 <a> 标签），但即使有跨块标签，客户端 buffer 方案仍比逐段 += innerHTML 更健壮；
- 防范 XSS 风险：若流内容来自不可信源（如用户输入未经清洗的 LLM 输出），请先对 event.data 做 HTML 转义或使用 DOMPurify.sanitize() 过滤后再注入，切勿直接信任并渲染；
- 性能提示：对超长内容（如万字富文本），频繁重写 innerHTML 可能引发重排重绘。此时可考虑节流（throttle）更新频率，或改用 documentFragment + insertAdjacentHTML 进行局部追加（需自行处理标签完整性逻辑）。
总结：流式 HTML 渲染的核心原则是 “累积 → 完整 → 替换”，而非 “接收 → 拼接 → 追加”。这一模式既保障了 HTML 解析的正确性，又保持了流式响应的实时性，是构建 AI 对话、日志流、富文本推送等交互界面的可靠基础实践。
立即学习“前端免费学习笔记（深入）”；
