SvelteKit 中如何优化预渲染页面的数据加载问题

在 SvelteKit 项目中，当使用 adapter-static 进行静态站点生成时，开发者可能会遇到预渲染页面体积过大的问题。这个问题通常源于 SvelteKit 的数据获取机制在服务器端渲染(SSR)时的行为特性。

问题背景

当我们在 SvelteKit 的顶层布局文件(+layout.ts)中使用 fetch 加载大型数据文件时，SvelteKit 会将这些获取的数据以 base64 编码的形式内联到 HTML 中，存储在 data-sveltekit-fetched 脚本标签内。对于包含数千条记录的大型数据集，这会导致每个预渲染页面的体积急剧膨胀，最终生成的静态网站可能达到 GB 级别。

技术原理分析

SvelteKit 的这种设计有其合理性：

1. 它确保了客户端在导航时能够快速获取已缓存的数据
2. 避免了客户端再次请求相同数据的网络延迟
3. 保持了服务器端和客户端渲染的一致性

然而，在静态站点生成的场景下，这种机制反而成为了负担，因为：

1. 相同的数据会被重复内联到每个页面中
2. 预渲染过程会为每个路由重新执行数据获取
3. 无法直接传递非 POJO(普通 JavaScript 对象)类型的数据

解决方案探索

1. 使用原生 fetch 替代

在 load 函数中使用浏览器原生的 fetch 而非 SvelteKit 提供的 fetch，可以避免数据内联。但需要注意：

• 在 SSR 时不能使用相对路径
• 需要处理服务器和客户端环境的差异

2. 客户端数据加载

将数据获取逻辑移至 onMount 生命周期钩子中：

• 优点：完全避免了 SSR 时的数据内联
• 缺点：失去了服务器端渲染的优势，可能导致页面内容闪烁

3. 服务器 load 函数

使用服务器专用的 load 函数(+page.server.ts)：

• 预渲染时数据不会内联到 HTML
• 但只能传递可序列化的 POJO 数据
• 无法传递自定义类实例

4. HTML 后处理

通过 SvelteKit 的 transformPageChunk 钩子移除内联脚本：

export const handle: Handle = async ({ event, resolve }) => {
    const response = await resolve(event, {
        transformPageChunk: ({ html, done }) => {
            if (done) {
                return html.replace(/<script.*data-sveltekit-fetched.*<\/script>/g, "");
            }
            return html;
        }
    });
    return response;
};

这种方法虽然有效，但不够优雅，且存在性能浪费。

性能优化建议

对于需要预渲染大量动态路由(如 /detail/[slug])的场景：

1. 考虑将共享数据提取到单独的文件中，通过 import 直接引入
2. 实现数据的分块加载，只加载当前页面需要的数据
3. 使用 Vite 的资产处理能力优化大型 JSON 文件的导入
4. 对于类实例，考虑将其方法转为纯函数，通过辅助工具类管理状态

最佳实践

1. 对于静态站点生成，优先考虑通过 import 直接引入数据文件
2. 如果必须使用 fetch，考虑开发自定义 fetch 包装器处理环境差异
3. 对于大量路由的预渲染，评估是否真的需要完全静态化，或考虑混合渲染策略
4. 使用性能分析工具监控 SSR 过程中的瓶颈

通过合理选择数据加载策略，开发者可以在保持 SvelteKit 优势的同时，有效控制预渲染页面的体积和生成效率。