Next.js将server.js移至独立后端文件夹后无法运行如何解决

你把包含server.js在内的后端文件迁移到独立文件夹后，按以下步骤修改配置即可正常启动：

1. 修改package.json启动脚本路径 #

把脚本中原来指向根目录server.js的启动命令，替换为新目录下server.js的实际路径。
假设你将所有后端文件统一存放在根目录下的/server文件夹，入口文件为/server/server.js，修改后的scripts配置如下：

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

如果你的后端目录命名为其他名称（比如backend），把路径里的server替换成实际目录名即可。

2. 修正server.js中Next实例的初始化参数 #

这是最容易遗漏的配置：当server.js不在Next.js应用根目录时，Next默认会从server.js所在目录查找项目配置、页面文件，必须手动通过dir参数指定Next.js项目的根目录路径。
修改server.js中的Next初始化代码：

const next = require('next')
const path = require('path')
const dev = process.env.NODE_ENV !== 'production'

// 新增dir配置，指向next.config.js所在的项目根目录
const app = next({
  dev,
  dir: path.resolve(__dirname, '../') // 示例中server.js在/server目录下，../就是项目根目录
})
const handle = app.getRequestHandler()

// 后续端口监听、自定义路由逻辑不需要改动

3. 校验路径引用 #

• 后端内部文件（路由、工具函数、配置文件等）的互相引用，要按照迁移后的目录结构调整相对路径，避免引用报错。
• 后端目录不要放在Next.js的/pages、/app、/public等Next默认托管的目录下，避免被Next识别为前端路由/静态资源异常打包。

常见启动报错排查 #

• 报Could not find a pages directory/找不到next.config.js：检查dir参数的路径是否正确指向Next根目录。
• 报模块找不到：检查后端文件的require/import引用路径是否匹配新目录结构。
• 生产环境启动后接口404：检查启动脚本里的server.js路径是否正确，确认启动的是新目录下的服务文件。

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