Next.js是否有仅执行一次的服务端启动方法？配置node-postgres类型解析

代码放置位置与全局生效方案 #

要让node-postgres的类型解析规则在整个Next.js应用中全局生效，你可以把配置代码放在以下几个位置，确保服务端仅执行一次：

1. 使用lib目录下的初始化文件（推荐） #

在项目根目录创建lib/pg-init.js文件，写入你的配置代码：

import { types } from 'pg';

// 覆盖默认的bigint类型解析（OID 20对应PostgreSQL的bigint）
types.setTypeParser(20, (val) => parseInt(val, 10));

然后在服务端入口文件中导入这个模块，比如在pages/api/_app.js（Pages Router）或者app/api/route.js（App Router）的顶部导入：

// 在服务端代码的最顶部导入，确保初始化优先执行
import '../../lib/pg-init';

Next.js在服务端启动时会加载这些模块，且只会执行一次，保证配置全局生效。

2. Pages Router：利用getServerSideProps初始化 #

如果你的项目用的是Pages Router，可以在_app.js的getServerSideProps中执行初始化，通过全局标记避免重复执行：

import { types } from 'pg';

let pgInitialized = false;

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

export async function getServerSideProps() {
  if (!pgInitialized) {
    types.setTypeParser(20, (val) => parseInt(val, 10));
    pgInitialized = true;
  }
  return { props: {} };
}

export default MyApp;

这种方式会在首次服务端渲染时执行初始化，后续请求不会重复运行。

3. App Router：根布局服务端组件初始化 #

对于App Router，可以在根布局（app/layout.js，服务端组件）中执行初始化，同样通过全局标记控制执行次数：

import { types } from 'pg';

let pgInitialized = false;

if (!pgInitialized) {
  types.setTypeParser(20, (val) => parseInt(val, 10));
  pgInitialized = true;
}

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

根布局作为服务端组件，只会在服务端启动时初始化一次，后续请求复用该配置。

Next.js中仅运行一次的服务端启动实现方式 #

Next.js本身没有专门的"服务端启动钩子"，但可以通过以下方式实现类似效果：

• 利用Node.js模块单例加载机制：将初始化代码放在独立模块中，在服务端入口导入，模块会被仅加载执行一次。
• 全局变量标记：在服务端代码中通过全局变量判断是否已完成初始化，避免重复执行逻辑。
• 自定义服务器（server.js）：如果项目使用自定义Express服务器，可以直接在服务器启动代码中添加配置，确保只运行一次：

const { createServer } = require('http');
const { parse } = require('url');
const next = require('next');
const { types } = require('pg');

// 初始化pg类型解析
types.setTypeParser(20, (val) => parseInt(val, 10));

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

app.prepare().then(() => {
  createServer((req, res) => {
    const parsedUrl = parse(req.url, true);
    handle(req, res, parsedUrl);
  }).listen(3000, (err) => {
    if (err) throw err;
    console.log('> Ready on http://localhost:3000');
  });
});

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