SvelteKit自定义Express服务器引发404及构建错误求助

一、修复/expresskit接口404错误 #

1. 调整路由挂载顺序 #

Express路由匹配遵循先定义先匹配规则，必须先注册你的自定义路由，再挂载SvelteKit的handler中间件。否则SvelteKit会优先捕获所有请求，导致自定义路由无法命中：

// 项目根目录/server.js
import express from 'express';
import { handler } from './build/handler.js';
import cors from 'cors';

const app = express();

// 先配置CORS
app.use(cors());

// 先注册自定义路由
app.get('/healthcheck', (req, res) => {
  res.json({ status: 'ok' });
});

app.get('/expresskit', (req, res) => {
  res.json({ message: '来自Express的响应' });
});

// 最后挂载SvelteKit handler，处理所有未匹配的路由
app.use(handler);

app.listen(3000, () => {
  console.log('服务器运行在http://localhost:3000');
});

2. 确认fetch请求路径 #

在+page.svelte中确保请求路径与自定义路由完全一致：

<script>
  async function fetchExpressData() {
    const res = await fetch('/expresskit');
    if (!res.ok) throw new Error('请求失败');
    const data = await res.json();
    console.log(data);
  }
</script>

<button on:click={fetchExpressData}>获取Express数据</button>

二、修复npm run build时的405错误 #

该错误是因为SvelteKit构建过程会校验路由，需添加错误处理逻辑：

1. 在自定义服务器中添加错误处理中间件 #

在app.use(handler)之后追加通用错误处理：

// server.js末尾
app.use((err, req, res, next) => {
  if (err.status === 405) {
    res.status(405).json({ error: '请求方法不允许' });
  } else {
    res.status(err.status || 500).send(err.message || '服务器内部错误');
    console.error(err.stack);
  }
});

2. 配置SvelteKit全局错误处理 #

在src/hooks.server.js中实现handleHttpError：

export function handleHttpError({ error, event }) {
  return new Response(JSON.stringify({ error: error.message }), {
    status: error.status || 500,
    headers: { 'Content-Type': 'application/json' }
  });
}

三、让构建脚本指向自定义服务器 #

修改package.json的scripts字段，替换默认的启动命令：

{
  "scripts": {
    "dev": "node server.js",       // 开发环境启动自定义服务器
    "build": "vite build",         // 构建SvelteKit项目生成build目录
    "preview": "node server.js"    // 预览构建后的项目（用自定义服务器）
  }
}

• 执行npm run build后，会在根目录生成build文件夹，内含SvelteKit编译后的handler和静态资源
• 开发/预览时必须用npm run dev/npm run preview启动自定义服务器，而非默认的vite dev

必备依赖安装 #

确保已安装所需包：

npm install express cors

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