You need to enable JavaScript to run this app. 解决Serverless+TS+Express+TypeORM下sls offline访问/documents报错问题
优惠活动
大模型
产品
解决方案
定价
更多

解决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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.11 17:36:01