服务端渲染（SSR）React 组件

安装 react 和 react-dom：

terminal

# 可以使用任何包管理器
bun add react react-dom

要在服务器端（SSR）将 React 组件渲染为 HTML 流：

ssr-react.tsx

import { renderToReadableStream } from "react-dom/server";

function Component(props: { message: string }) {
  return (
    <body>
      <h1>{props.message}</h1>
    </body>
  );
}

const stream = await renderToReadableStream(<Component message="来自服务器的问候！" />);

将其与 Bun.serve() 结合以创建一个 SSR HTTP 服务器：

server.tsx

Bun.serve({
  async fetch() {
    const stream = await renderToReadableStream(<Component message="来自服务器的问候！" />);
    return new Response(stream, {
      headers: { "Content-Type": "text/html" },
    });
  },
});

React 19 及更高版本包含一个 SSR 优化，利用了 Bun 的”直接” ReadableStream 实现。如果你遇到类似 export named 'renderToReadableStream' not found 的错误，请安装 react 和 react-dom 的 19 版本，或者从 react-dom/server.browser 而非 react-dom/server 导入。详情请参见 facebook/react#28941。

概览

部署

运行时与调试

实用工具

生态系统与框架

HTTP 与网络

WebSocket

进程与系统

包管理器

测试运行器

运行时与调试

模块系统

文件系统

实用工具

HTML 处理

二进制数据

流

服务端渲染（SSR）React 组件