如何在Next.js 14 API中维持PostgreSQL持久连接，避免重复创建？

核心问题定位 #

你的问题本质是get users接口每次请求都重复初始化了TypeORM的DataSource，而login接口复用了全局初始化的连接实例。要实现持久化连接复用，必须保证整个应用生命周期内只创建并初始化一次DataSource实例。

具体解决方案 #

1. 重构DataSource初始化逻辑 #

确保data-source.ts只导出一个全局的DataSource实例，避免在接口内重复创建：

import { DataSource } from "typeorm";
import { User } from "./entities/User"; // 替换为你的实体类

export const AppDataSource = new DataSource({
  type: "postgres",
  host: "localhost",
  port: 5432,
  username: "你的数据库用户名",
  password: "你的数据库密码",
  database: "你的数据库名",
  entities: [User],
  synchronize: false,
  logging: false,
});

2. 在应用启动时完成连接初始化 #

在应用入口文件（如index.ts/server.ts）中提前初始化数据库连接，而不是在请求时才处理：

import { AppDataSource } from "./data-source";
import express from "express";

const app = express();

async function startServer() {
  try {
    // 启动时一次性初始化连接
    await AppDataSource.initialize();
    console.log("数据库连接已建立");

    // 挂载路由
    app.use("/api", require("./route"));

    app.listen(3000, () => {
      console.log("服务器运行在端口3000");
    });
  } catch (error) {
    console.error("数据库连接初始化失败:", error);
    process.exit(1);
  }
}

startServer();

3. 修改接口逻辑，复用全局连接 #

确保所有接口直接使用已初始化的AppDataSource实例，禁止在接口内重复初始化：

示例db.ts（若存在此文件）：

import { AppDataSource } from "./data-source";
import { User } from "./entities/User";

// 直接导出已初始化的实体仓库
export const UserRepository = AppDataSource.getRepository(User);

示例route.ts：

import express from "express";
import { UserRepository } from "./db";

const router = express.Router();

// Login接口
router.post("/login", async (req, res) => {
  try {
    const user = await UserRepository.findOneBy({
      username: req.body.username
    });
    // 业务逻辑...
    res.json({ success: true, user });
  } catch (err) {
    res.status(500).json({ error: err.message });
  }
});

// Get Users接口
router.get("/users", async (req, res) => {
  try {
    const users = await UserRepository.find();
    res.json(users);
  } catch (err) {
    res.status(500).json({ error: err.message });
  }
});

module.exports = router;

4. 排查重复初始化点 #

• 检查get users接口是否存在await AppDataSource.initialize()或重复创建DataSource实例的代码，这类操作会导致每次请求尝试新建连接。
• 确保所有业务逻辑都引用同一个全局AppDataSource实例，避免局部重新定义。

验证连接复用 #

启动应用后，通过PostgreSQL的pg_stat_activity视图查看连接状态，多次调用get users接口，确认连接数不会持续增长，而是复用已建立的连接。

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