如何在Next.js启动服务器时与Sequelize同步模型？

之前用Express+React时，习惯在server.js启动阶段同步数据库，但Next.js没有默认的server.js文件，目前临时在登录/注册接口中调用sequelize.sync()，但这种方式会在每次接口请求时重复执行，既影响性能也可能引发问题。以下是几种可靠的解决方案，实现服务器启动时仅同步一次模型：

方案一：自定义Next.js服务器（推荐，Pages Router） #

通过创建自定义服务器文件，在Next.js启动前完成数据库同步，完全可控且不会重复执行。

1. 在项目根目录创建server.js：

const { createServer } = require('http');
const { parse } = require('url');
const next = require('next');
const sequelize = require('./src/db/config/connections');
// 导入所有模型（如果有多个模型，建议统一在model/index.js导出后导入）
require('./src/db/model/user');

const dev = process.env.NODE_ENV !== 'production';
const app = next({ dev });
const handle = app.getRequestHandler();

// 启动前同步数据库
app.prepare().then(async () => {
  await sequelize.sync({ force: false });
  console.log('✅ 数据库模型同步完成');

  createServer((req, res) => {
    const parsedUrl = parse(req.url, true);
    handle(req, res, parsedUrl);
  }).listen(3000, (err) => {
    if (err) throw err;
    console.log('> 服务已启动：http://localhost:3000');
  });
});

2. 修改package.json的启动脚本，替换默认的Next.js启动命令：

"scripts": {
  "dev": "node server.js",
  "build": "next build",
  "start": "NODE_ENV=production node server.js"
}

方案二：在_app.js中执行服务器端初始化（Pages Router） #

利用Next.js的页面初始化逻辑，仅在服务器端执行同步操作，适合不想自定义服务器的场景。

在src/pages/_app.js中添加初始化逻辑：

import '../styles/globals.css';
import sequelize from '../db/config/connections';
import '../db/model/user';

// 标记是否已同步，避免开发模式热重载重复执行
let isSynced = false;

async function initDatabase() {
  // 仅在服务器端执行（typeof window === 'undefined' 是Next.js判断服务器端的标准方式）
  if (typeof window === 'undefined' && !isSynced) {
    await sequelize.sync({ force: false });
    console.log('✅ 数据库模型同步完成');
    isSynced = true;
  }
}

// 触发初始化
initDatabase();

export default function MyApp({ Component, pageProps }) {
  return <Component {...pageProps} />;
}

方案三：App Router 环境下的初始化 #

如果使用Next.js 13+的App Router，可以在根布局中编写服务器端逻辑：

在src/app/layout.js中添加：

import sequelize from '../db/config/connections';
import '../db/model/user';

// 服务器端自动执行
async function initDatabase() {
  await sequelize.sync({ force: false });
  console.log('✅ 数据库模型同步完成');
}
initDatabase();

export default function RootLayout({ children }) {
  return (
    <html lang="zh-CN">
      <body>{children}</body>
    </html>
  );
}

注意事项 #

• 确保所有模型都被正确导入，否则Sequelize无法识别未导入的模型进行同步。建议在src/db/model下创建index.js统一导出所有模型，方便后续维护：

  // src/db/model/index.js
  const User = require('./user');
  // 新增模型后在这里添加导出
  module.exports = { User };
  

  后续初始化时只需导入require('./src/db/model')即可。
• sequelize.sync({ force: false })中的force参数设为true会删除现有表并重建，开发环境可以临时使用，生产环境务必保持false。

内容的提问来源于stack exchange，提问作者Mony Sary