在 vite 项目中实现服务端渲染(ssr),核心做法是安装 @vitejs/plugin-react-refresh 或对应的框架插件,并在构建时分别运行客户端和服务端的构建命令。具体操作是通过 vite build --ssr 生成用于 node.js 环境的入口文件,配合 vite-ssr 或手动配置 express/koa 中间件来启动服务。这样做会得到一个包含预渲染 html 和可执行 js 的 ssr 应用,首屏加载速度显著提升。

Vite 中如何配置 SSR 插件与入口文件
要启用 SSR,必须在 vite.config.js 中引入对应的插件,例如 React 项目需使用 @vitejs/plugin-react 并开启 SSR 模式。同时需要创建两个入口文件:client-entry.tsx 用于浏览器端 hydration,server-entry.tsx 用于服务端渲染。配置完成后,Vite 能正确识别不同环境的依赖。

// vite.config.js
import { defineConfig } from 'vite'
import react from '@vitejs/plugin-react'
export default defineConfig({
plugins: [react()],
ssr: {
noExternal: [] // 默认将 node_modules 中的包视为外部化
}
})
上述配置中,ssr.noExternal 为空表示所有 node_modules 中的包都将被打包进 SSR bundle。如果某些包不支持 CommonJS 或存在兼容问题,可以将其加入此数组强制打包。入口文件 server-entry.tsx 通常导出一个 render 函数,接收请求上下文并返回 HTML 字符串。
Express 服务器如何集成 Vite SSR 中间件
在开发环境中,Vite 提供 viteSSR 中间件来自动处理热更新和 SSR 逻辑。在生产环境中,则需要手动配置 Express 路由,调用 Vite 构建后的 ssrManifest 和 renderModule 方法。通过 app.use(viteSSR(app)) 可以快速接入开发服务器,而生产环境需读取 .vite/ssr-manifest.json 以优化资源加载。

// server.js
import express from 'express'
import { createServer as createViteServer } from 'vite'
async function createServer() {
const app = express()
const vite = await createViteServer({
server: { middlewareMode: true },
appType: 'custom'
})
app.use(vite.middlewares)
app.get('*', async (req, res) => {
const template = await fs.readFile('./index.html', 'utf-8')
const html = await vite.transformIndexHtml(req.originalUrl, template)
res.status(200).set({ 'Content-Type': 'text/html' }).end(html)
})
app.listen(3000)
}
createServer()
这段代码展示了基本的 Express 集成流程。关键点在于 middlewareMode: true 让 Vite 作为中间件运行,而非独立服务器。在处理路由时,vite.transformIndexHtml 负责注入 SSR 所需的脚本标签和资源链接。若使用生产构建,需替换为读取 dist/client/index.html 和调用 require('./dist/ssr/main.js') 的方式。
SSR 构建产物中如何处理 CSS 提取与加载
在 SSR 场景下,CSS 的处理方式与客户端不同。Vite 默认会将样式内联到 HTML 中或通过 标签异步加载。对于 SSR,通常需要确保在服务端渲染时,关键 CSS 被直接注入到 HTML 头部,以避免 FOUC(无样式内容闪烁)。这可以通过配置 @vitejs/plugin-react 的 ssrCss 选项或使用 postcss 插件实现。
当构建 SSR 应用时,vite build --ssr 生成的 dist/ssr/ 目录包含服务端可执行的 JS 文件。这些文件不包含 CSS,因为 CSS 由客户端构建产物 dist/client/ 提供。在渲染过程中,服务端需从 ssrManifest 中读取当前组件依赖的 CSS 文件,并将其插入到 HTML 的 中。这种分离确保了客户端按需加载 CSS,而服务端只负责提供初始 HTML 结构。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











