SvelteKit 1.20.4：如何在服务器处理请求前运行初始化代码

环境信息 #

• sveltekit 1.20.4
• svelte 4.0.5
• vite
• adapter-node

需求与问题描述 #

需要在服务器开始处理请求之前运行多个服务的初始化代码，且初始化必须在启动服务器时执行，而非hooks.server.js中第一个钩子触发时。此前尝试将初始化函数放在handle钩子外，但因ES模块/tree shaking机制，代码会在构建阶段执行，不符合预期。

补充说明：目标是能在项目任意位置（如+server.js）导入DB类并直接使用。如果初始化脚本作为构建流程的一部分，顶层代码会在构建时尝试建立连接；且构建后生成的分块文件位置和名称变化，无法直接导入。

现有hooks.server.js代码示例：

import db from 'db';
import redis from 'redis';
import wss from 'websocket';

const runAllTheInitFunctions = async () => {
    await db.init();
    // 其他初始化逻辑...
}

await runAllTheInitFunctions(); // 此处不可行，该放在哪里？

/** @type {import('@sveltejs/kit').Handle} */
export const handle = async ({ event, resolve }) => {
    // 请求处理逻辑...
}

希望找到无需在每次handle中检查初始化状态的优雅解决方案。

解决方案：自定义服务器入口（适配adapter-node） #

因为你使用的是adapter-node，可以通过自定义服务器入口来实现启动时初始化，完全避开构建阶段执行的问题，步骤如下：

1. 创建自定义服务器文件 #

在项目根目录新建server.js，内容如下：

import { handler } from './build/handler.js';
import express from 'express';
// 按实际项目路径导入你的服务模块
import db from './src/lib/db.js';
import redis from './src/lib/redis.js';
import wss from './src/lib/websocket.js';

const app = express();

// 封装所有初始化逻辑
const initServices = async () => {
    await db.init();
    await redis.init();
    await wss.init();
    console.log('所有服务初始化完成');
};

// 先完成初始化，再启动服务器监听请求
initServices().then(() => {
    app.use(handler);

    const PORT = process.env.PORT || 3000;
    app.listen(PORT, () => {
        console.log(`服务器运行在 http://localhost:${PORT}`);
    });
}).catch(err => {
    console.error('初始化失败:', err);
    process.exit(1);
});

2. 更新package.json脚本 #

修改构建和启动命令，确保先构建再用自定义服务器启动：

{
  "scripts": {
    "build": "vite build",
    "start": "node server.js"
  }
}

3. 调整服务模块逻辑 #

确保你的DB、Redis等模块的初始化逻辑是封装成方法（比如init()），而非顶层自动执行的代码。这样只有在自定义服务器中调用init()时才会建立连接，避免构建阶段触发不必要的连接操作。

更贴合SvelteKit生态的替代方案 #

如果你不想额外维护自定义服务器，可以利用adapter-node的内置特性：在项目src目录下新建server.js，SvelteKit会自动将其作为服务器入口，通过导出setup函数实现启动前初始化：

import db from '$lib/db.js';
import redis from '$lib/redis.js';
import wss from '$lib/websocket.js';

export async function setup({ app, platform }) {
    // 在这里执行所有初始化
    await db.init();
    await redis.init();
    await wss.init();
}

构建完成后，adapter-node会自动在服务器启动前调用setup函数，确保初始化完成后再处理请求。

方案优势 #

• 初始化逻辑完全在服务器启动阶段执行，和构建流程彻底分离，避免tree shaking导致的提前执行问题。
• 所有请求处理前服务已就绪，无需在handle钩子中反复检查初始化状态。
• 项目其他文件（如+server.js）可直接导入服务模块使用，无需额外处理初始化状态。

内容的提问来源于stack exchange，提问作者LAZ