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
相关产品推荐
相关产品推荐

