You need to enable JavaScript to run this app. Next.js Express自定义服务器dev:true时无限加载空响应,生产模式正常
优惠活动
大模型
产品
解决方案
定价
更多

Next.js Express自定义服务器dev:true时无限加载空响应,生产模式正常

Next.js自定义Express服务器开发模式空响应问题排查与解决方案

核心问题根因

dev模式下Next.js需要执行webpack初始化、页面预编译等准备工作,必须通过app.prepare()等待所有准备工作完成后再挂载请求处理逻辑,否则请求会被未初始化的处理函数卡住,最终返回空响应。生产模式下所有资源已提前通过next build编译完成,不需要执行prepare阶段的编译逻辑,因此可以直接正常运行。

具体修复方案

修正你的自定义Next路由代码,添加初始化等待逻辑:

const next = require('next')
const app = next({ dev: true, dir: './', conf: { } })

module.exports = async router => {
  // 等待Next.js开发模式初始化完成
  await app.prepare()
  const handle = app.getRequestHandler()
  router.all('*', (req, res) => handle(req, res))
}

调整Express主服务的启动逻辑,确保路由挂载前已经完成Next初始化:

const express = require('express')
const nextRouter = require('./你的Next路由文件路径')
const server = express()
const PORT = 3000

// 异步初始化后启动服务
;(async () => {
  // 如果直接挂载到根路径:
  await nextRouter(server)
  // 如果要挂载到指定前缀,使用以下写法:
  // const router = express.Router()
  // await nextRouter(router)
  // server.use('/custom/uibackend/next', router)
  server.listen(PORT, () => console.log(`服务运行在端口${PORT}`))
})()

其他排查验证点

  • 确认next.config.js中的basePath配置与你挂载的路由前缀完全匹配,无多余/缺失的斜杠
  • 开发模式启动后等待控制台输出编译完成的提示后再访问页面,避免正在编译时请求超时
  • 删除项目根目录下的.next缓存文件夹后重新启动服务,排除旧缓存导致的异常
  • 不要同时运行next dev命令和你的自定义Express启动命令,仅直接启动你的Express入口文件即可

内容的提问来源于stack exchange,提问作者Adis

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.16 12:45:08