NextJS+TypeORM部署Vercel启动报错：实体元数据未找到，构建后.next目录无实体文件

开发者阿泽

2026-4-8

兄弟，我之前做Next.js + TypeORM项目部署Vercel时，碰到过几乎一模一样的坑！本地dev和build都顺顺利利，一到生产环境启动就报实体元数据找不到，一看.next目录里果然没把实体文件打包进去，当时头都大了，折腾好一阵才搞定，给你分享几个亲测有效的解决办法：

先把TypeORM的实体路径配置对
你大概率是在data-source.ts（或者旧版的ormconfig.json）里写死了实体路径吧？开发时我们用的是.ts文件，但Next.js build后会把TS转成JS，生产环境得找.js的实体文件，而且得用动态路径别写死。我当时是这么改的：

import path from 'path';
import { DataSource } from 'typeorm';

const isProduction = process.env.NODE_ENV === 'production';
const entitiesDir = isProduction 
  ? path.join(__dirname, '../entity/**/*.js') 
  : path.join(__dirname, '../entity/**/*.ts');

export const AppDataSource = new DataSource({
  type: 'postgres',
  url: process.env.DATABASE_URL,
  entities: [entitiesDir],
  synchronize: false, // 生产环境千万别开synchronize！
  ssl: isProduction ? { rejectUnauthorized: false } : false,
});

用__dirname动态拼接路径，再根据环境切换.ts/.js后缀，比写死路径靠谱多了。

让Next.js别忽略你的实体文件
Next.js默认只会打包它认为“有用”的文件，比如页面、组件这些，像src/entity下的纯TS文件，它会直接忽略，根本不会转译打包到.next里——这就是build后找不到实体文件的核心原因！
解决办法很简单，在next.config.js里配置transpilePackages，把实体所在的目录加进去，告诉Next.js：“这个目录的文件你也得帮我转译打包！”
比如你的实体在src/entity，next.config.js这么写：
```
/** @type {import('next').NextConfig} */
const nextConfig = {
  transpilePackages: ['src/entity'],
};

module.exports = nextConfig;
```
检查实体文件名有没有坑
看你报错里的_#exhibits，你的实体文件名是不是下划线开头？比如_Exhibits.ts？我之前踩过这个坑，Next.js对下划线开头的文件会有奇怪的处理，要么直接忽略，要么转译出问题，TypeORM也可能识别不到这种命名的实体。你可以先把文件名改成正常的（比如Exhibit.ts），再重新build试试，说不定问题直接就解决了。
确保数据库连接只在服务器端运行
绝对别在客户端组件里初始化TypeORM连接！一定要把数据库连接逻辑放到服务器端代码里，比如src/lib/db.ts，用单例模式确保只初始化一次：
```
import { AppDataSource } from './data-source';

let dataSourceInstance;

export async function getDB() {
  if (!dataSourceInstance) {
    dataSourceInstance = await AppDataSource.initialize();
  }
  return dataSourceInstance;
}
```
然后在API路由或者服务器组件里调用getDB()，客户端组件碰都别碰数据库连接的代码，不然不仅会报错，还可能泄露数据库信息！

我当时就是先改了next.config.js的transpilePackages，再调整了实体路径，重新build后.next目录里就出现实体的JS文件了，启动时也没再报元数据找不到的错。你可以挨个试试这些方法，应该能搞定你的问题！

内容来源于stack exchange