我太懂你这种折腾好几天卡壳的感觉了——Next.js配TypeORM确实比Prisma麻烦不少，毕竟Prisma对Next.js的适配做得太贴心了。不过别慌，我来一步步给你拆解怎么搞定连接和实际使用，再给你分享些靠谱的学习方向。

第一步：先把TypeORM的连接配置适配Next.js环境 #

Next.js区分客户端和服务端运行环境，不能像普通Node项目那样直接在入口初始化连接，得做个单例管理避免重复连接。

首先检查你的ormconfig.js（换成ormconfig.ts更贴合TypeScript项目）配置是否正确，参考这个模板：

module.exports = {
  type: "postgres",
  host: process.env.DB_HOST || "localhost",
  port: parseInt(process.env.DB_PORT) || 5432,
  username: process.env.DB_USERNAME,
  password: process.env.DB_PASSWORD,
  database: process.env.DB_NAME,
  entities: ["src/entities/**/*.ts"], // 生产环境要改成dist/entities/**/*.js
  synchronize: process.env.NODE_ENV !== "production", // 划重点：生产环境绝对不能开这个！
  logging: process.env.NODE_ENV === "development",
}

然后创建一个连接管理工具文件，比如src/utils/typeorm.ts，用来统一获取数据库连接：

import "reflect-metadata"; // 必须在TypeORM之前导入，不然实体装饰器会失效
import { createConnection, getConnection, Connection } from "typeorm";
import config from "../../ormconfig"; // 对应你的配置文件路径

let connection: Connection | null = null;

export async function getDbConnection(): Promise<Connection> {
  // 如果已有连接且正常，直接返回
  if (connection && connection.isConnected) {
    return connection;
  }

  try {
    connection = await createConnection(config);
    return connection;
  } catch (error) {
    // 处理连接异常：如果存在失效连接，先关闭再重建
    if (getConnection()) {
      await getConnection().close();
    }
    connection = await createConnection(config);
    return connection;
  }
}

第二步：在Next.js里实际用TypeORM（分两种场景） #

1. 在Pages Router的API路由中使用 #

比如pages/api/users.ts，这是纯服务端运行的代码，可以直接调用连接：

import { NextApiRequest, NextApiResponse } from "next";
import { getDbConnection } from "../../utils/typeorm";
import { User } from "../../entities/User"; // 你的实体类

export default async function handler(req: NextApiRequest, res: NextApiResponse) {
  const connection = await getDbConnection();
  const userRepo = connection.getRepository(User);

  if (req.method === "GET") {
    const users = await userRepo.find();
    res.status(200).json(users);
  } else if (req.method === "POST") {
    const newUser = userRepo.create(req.body);
    await userRepo.save(newUser);
    res.status(201).json(newUser);
  } else {
    res.setHeader("Allow", ["GET", "POST"]);
    res.status(405).end(`Method ${req.method} Not Allowed`);
  }
}

2. 在App Router的服务器组件中使用（Next.js 13+） #

如果用App Router，服务器组件可以直接处理数据库逻辑：

// app/users/page.tsx
import { getDbConnection } from "@/utils/typeorm";
import { User } from "@/entities/User";

export default async function UsersPage() {
  const connection = await getDbConnection();
  const users = await connection.getRepository(User).find();

  return (
    <div>
      <h1>用户列表</h1>
      <ul>
        {users.map(user => (
          <li key={user.id}>{user.name}</li>
        ))}
      </ul>
    </div>
  );
}

⚠️ 注意：客户端组件绝对不能直接用TypeORM，必须通过API路由或者服务器组件传递数据——因为客户端环境没有Node.js的PostgreSQL驱动支持。

避坑指南（你大概率踩过的坑） #

• 实体路径问题：开发环境用src/entities/**/*.ts，生产环境要改成dist/entities/**/*.js，或者用绝对路径避免编译后找不到文件。
• 环境变量：服务器端用的数据库变量（比如DB_HOST）不需要加NEXT_PUBLIC_前缀，直接放在.env.local里就行。
• Synchronize选项：生产环境一定要关掉synchronize: true！这个选项会自动同步实体到数据库表，生产环境用极易导致数据丢失或结构混乱，建议用TypeORM的迁移脚本（typeorm migration:generate）来管理表结构变更。
• 重复连接：必须用单例模式管理连接，不然每个API请求都创建新连接会把数据库资源耗光。

关于优质教程的建议（无外链纯干货） #

其实不用找第三方教程，最靠谱的是结合官方文档+实战思路：

1. 先在纯Node.js项目里把TypeORM的基础用法（实体、连接、仓库、迁移）跑通，再迁移到Next.js，这样能分清是TypeORM的问题还是Next.js的适配问题。
2. 去Next.js官方讨论区搜TypeORM相关话题，很多开发者会分享自己踩坑后的配置方案，比如App Router和Pages Router的差异处理。
3. 看开源项目源码：在GitHub搜“nextjs typeorm postgresql”，找star多的项目，参考他们的连接封装、迁移脚本配置、数据库操作封装方式。

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