自定义服务器

Next.js 默认情况下包含其自己的服务器，通过 next start 启动。如果您有现有的后端，您仍然可以使用 Next.js（这不是自定义服务器）。自定义 Next.js 服务器允许您以编程方式启动服务器以实现自定义模式。大多数情况下，您不需要这种方法。但是，如果您需要弹出，它可以使用。

了解一下:

在决定使用自定义服务器之前，请记住，只有在 Next.js 的集成路由无法满足您的应用程序需求时才应使用它。自定义服务器将删除重要的性能优化，例如 **自动静态优化**。

自定义服务器**无法**部署在 Vercel 上。

使用独立输出模式时，它不会跟踪自定义服务器文件。此模式会改为输出一个单独的最小 server.js 文件。它们不能一起使用。

查看以下示例自定义服务器

server.ts

import { createServer } from 'http'
import { parse } from 'url'
import next from 'next'
 
const port = parseInt(process.env.PORT || '3000', 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(port)
 
  console.log(
    `> Server listening at https://127.0.0.1:${port} as ${
      dev ? 'development' : process.env.NODE_ENV
    }`
  )
})

server.js 不会通过 Next.js 编译器或捆绑过程运行。确保此文件所需的语法和源代码与您正在使用的当前 Node.js 版本兼容。查看示例。

要运行自定义服务器，您需要像这样更新 package.json 中的 scripts

package.json

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

或者，您可以设置 nodemon（示例）。自定义服务器使用以下导入将服务器与 Next.js 应用程序连接

import next from 'next'
 
const app = next({})

上面的 next 导入是一个函数，它接收一个包含以下选项的对象

选项	类型	描述
`conf`	`对象`	您在 `next.config.js` 中使用的相同对象。默认为 `{}`
`customServer`	`布尔值`	（可选）当服务器由 Next.js 创建时设置为 false
`dev`	`布尔值`	（可选）是否以开发模式启动 Next.js。默认为 `false`
`dir`	`字符串`	（可选）Next.js 项目的位置。默认为 `'.'`
`quiet`	`布尔值`	（可选）隐藏包含服务器信息的错误消息。默认为 `false`
`hostname`	`字符串`	（可选）服务器运行在其后的主机名
`port`	`数字`	（可选）服务器运行在其后的端口
`httpServer`	`node:http#Server`	（可选）Next.js 运行在其后的 HTTP 服务器
`turbo`	`布尔值`	（可选）启用 Turbopack

然后可以使用返回的 app 让 Next.js 根据需要处理请求。