如何在Next.js + Express项目中配置nodemon减少无意义重编译

架构老林

2026-10-25

问题根因

当前你的开发链路是整个Node进程为耦合单体结构：nodemon触发的是全进程级别的重启，每次重启都会重新执行Next.js实例的初始化流程，哪怕本次改动和前端代码完全无关，Next.js在dev模式下也会重新完成全量路由扫描、依赖收集、预构建流程，这就是你感知到的长等待来源。

最优解决方案：拆分独立进程

把耦合在同一个进程里的「自定义Express业务服务」和「Next.js前端编译服务」拆成两个独立运行的进程，彻底切断服务端代码改动对Next.js编译流程的影响，实现改服务端代码时秒级重载、完全不触发前端重编译。

具体操作步骤：

第一步，抽离独立的Next.js编译服务脚本，比如命名为next-dev.js
脚本内容如下，这个进程单独启动，不纳入nodemon的监听范围，只有修改前端代码时，才会由Next.js内置的热更新机制触发增量编译：

// next-dev.js
const { createServer } = require('http')
const next = require('next')
const dev = process.env.NODE_ENV !== 'production'
const nextApp = next({ dev, port: 3001 })

nextApp.prepare().then(() => {
  createServer(nextApp.getRequestHandler()).listen(3001, () => {
    console.log('Next.js dev 编译服务运行在 http://localhost:3001')
  })
})

第二步，改造原来的Express主文件，去掉和Next.js实例耦合的初始化逻辑，改成纯业务服务+请求代理模式
把所有前端相关的请求直接代理到已经独立运行的Next.js编译服务，不需要在Express进程里重复初始化Next实例：

注意：使用代理功能前需要先安装对应依赖 npm i http-proxy-middleware

// 改造后的app.js
const express = require("express");
const { createProxyMiddleware } = require('http-proxy-middleware');
const port = parseInt(process.env.PORT, 10) || 3000;

const server = express();
server.use(express.json());
// 挂载你所有自定义的服务端业务路由
require("./routes/indexRouter")(server);
// 所有前端路由请求统一代理到独立运行的Next.js服务
server.all("*", createProxyMiddleware({
  target: 'http://localhost:3001',
  changeOrigin: true
}));

server.listen(port, (err) => {
  if (err) throw err;
  console.log("> Ready on http://localhost:" + port);
});

第三步，确认nodemon配置仅监听服务端相关文件，和你现有配置保持一致即可，不需要调整：
```
{
  "verbose": true,
  "ignore": ["node_modules", ".next"],
  "watch": ["server/**/*", "app.js"],
  "ext": "js json"
}
```
第四步，调整开发启动命令，用多进程并行工具同时拉起两个独立服务：
先安装多进程运行依赖concurrently，再在package.json里配置对应的dev启动脚本：
```
"scripts": {
  "dev": "concurrently \"node next-dev.js\" \"nodemon app.js\""
}
```
这套链路下，修改任意服务端代码，只会触发Express业务进程的秒级重启，Next.js的编译进程全程不受影响，之前的编译缓存完全保留，根本不会触发无意义的全量重编译。

备选方案：轻量改造现有代码（无需拆进程）

如果你不想调整进程结构，只是想降低重启时的等待耗时，可以在现有代码基础上开启Next.js的持久化编译缓存，复用.next目录下已经生成的编译产物，跳过重复的全量扫描流程：

修改原来的Next.js初始化配置，显式开启编译缓存复用，降低dev模式下的多进程开销：
```
const app = next({ 
  dev,
  customServer: true,
  experimental: {
    cpus: 1
  }
});
```
确认nodemon.json的ignore字段已经包含.next目录，避免重启时清理已有编译缓存。
这种方式每次重启还是会走Next.js的初始化流程，但因为复用了已有缓存，等待时间会从几十秒压缩到数秒，不过无法达到拆进程方案的零重编译效果。

内容的提问来源于stack exchange，提问作者Лукас