解决Serverless+TS+Express+TypeORM下sls offline访问/documents报错问题
报错核心根因
你现在遇到的Cannot Get /documents完全是异步时序错位导致的,和TypeORM数据库连接正常运行没有冲突:
- 你把所有Express路由的注册逻辑全部写在了
createConnection()的.then()异步回调里 - 但
configureApp()函数本身是同步执行、立刻返回Express实例的——这意味着handler.ts初始化拿到Express实例的时候,所有路由都还没被挂载到app上 - 后续哪怕数据库连接走完、路由最终被挂上,serverless offline收到请求的时候,Express默认的404捕获逻辑已经先触发了,所以永远返回找不到路径的报错
- 你观察到TypeORM能正常建表,只是因为数据库的异步流程最终跑完了,不代表路由注册的时机在请求到达前已经完成
具体修复方案
- 第一,彻底拆分路由注册逻辑和数据库初始化逻辑:所有中间件挂载、Express路由的注册,全部放在app实例刚初始化的同步执行阶段,不要等数据库连接返回结果
- 第二,把数据库连接改成全局单例模式,既避免冷启动时重复建连、也不会把数据库初始化的时序和路由注册的时序绑定:
// 调整后的app.ts 核心逻辑 import * as express from 'express'; import { json, urlencoded } from 'body-parser'; import * as cors from 'cors'; import { eventContext } from 'aws-serverless-express/middleware'; import { createConnection } from "typeorm"; import { Routes } from "./src/routes/routes" import { Request, Response } from "express"; // 全局缓存数据库连接Promise,避免重复初始化 let cachedConnection: Promise<any>; export function configureApp() { const app = express(); // 中间件全部同步注册,不依赖数据库状态 app.use(cors()); app.use(json()); app.use(urlencoded({ extended: true })); app.use(eventContext()); // 路由全部同步注册,请求处理阶段再确保数据库连接可用 Routes.forEach(route => { (app as any)[route.method](route.route, async (req: Request, res: Response, next: Function) => { try { // 按需初始化/复用全局数据库连接 if (!cachedConnection) { cachedConnection = createConnection(); } await cachedConnection; const controllerResult = await (new (route.controller as any))[route.action](req, res, next); if (controllerResult !== null && controllerResult !== undefined) { res.send(controllerResult); } } catch (err) { next(err); } }); }); return app; }
- 第三,清理冗余代码:你原有代码里重复挂载了
json()、urlencoded()和单独引入的bodyParser.json(),属于重复挂载,保留一套body解析中间件即可 - 第四,本地调试时确认路由匹配路径:serverless offline默认会给路由加
/dev前缀,正常访问地址应该是http://localhost:3000/dev/documents,如果直接访问根路径下的/documents也会触发404;可以启动服务时看终端输出的路由列表,确认GET /documents路由已经被正确加载 - 第五,去掉原有逻辑里的无效代码:你等数据库连接完成后再判断
connection.isConnected、重复调用connection.connect()的逻辑是冗余的,createConnection()返回的Promise本身就代表连接已经建立,不需要二次校验
内容的提问来源于stack exchange,提问作者sharon.lavie
相关产品推荐
相关产品推荐

