如何在Node.js+Express+TypeScript项目中导入Svelte Node-adapter的handler.js？

核心问题原因 #

TypeScript无法识别handler.js的类型，因为Svelte Kit的adapter-node构建产物默认不带TypeScript声明文件，所以TS会把它标记为any类型并报错。

解决方案1：手动添加类型声明文件 #

在你的后端项目中，创建一个类型声明文件（比如src/build-handler.d.ts），内容如下：

declare module '../build/handler.js' {
  import type { RequestHandler } from 'express';
  export const handler: RequestHandler;
}

这个文件会告诉TypeScript：../build/handler.js模块导出了一个符合Express RequestHandler类型的handler变量。注意要根据你实际的导入路径调整声明里的模块路径，确保和import语句中的路径一致。

解决方案2：调整TypeScript配置（快速临时方案） #

如果不想写声明文件，可以修改后端项目的tsconfig.json：

• 开启allowJs: true，允许TypeScript导入JS文件
• 关闭checkJs: false，避免TypeScript检查JS文件的类型（可选，适合不需要对JS文件做类型检查的场景）

修改后的tsconfig.json相关配置示例：

{
  "compilerOptions": {
    // 其他已有配置...
    "allowJs": true,
    "checkJs": false
  }
}

不过这种方案会让TS对所有JS文件放松类型检查，不如方案1严谨。

额外操作校验 #

1. 确认Svelte项目已正确安装并配置@sveltejs/adapter-node，且npm run build成功生成了build/handler.js文件
2. 核对后端项目中../build/handler.js的路径是否正确：比如src/app.ts在src文件夹下，build文件夹和src同级的话路径是对的；如果build在src内部，路径要改成./build/handler.js

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