Next.js WebSocket连接失败致页面空白问题求助
解决Next.js HMR WebSocket连接失败导致空白页的问题
- 重启开发服务器:终端按
Ctrl+C终止当前服务,重新运行npm run dev(或yarn dev/pnpm dev,根据你的包管理器选择)。临时进程异常是这类问题的常见诱因,重启即可恢复。 - 强制刷新清除缓存:按
Ctrl+Shift+R(Windows/Linux)或Cmd+Shift+R(Mac)强制刷新页面,清除浏览器缓存的旧资源,避免新旧资源不兼容导致的加载异常。 - 检查端口占用:确认3000端口未被其他程序占用。Mac/Linux可运行
lsof -i :3000,Windows运行netstat -ano | findstr :3000查看占用进程,终止后重启服务。 - 临时禁用HMR测试:在
next.config.js中添加配置关闭热模块替换,验证页面是否能正常显示:
若页面恢复正常,说明HMR模块存在异常,可尝试更新Next.js版本解决。module.exports = { hotReload: false } - 排查防火墙/代理:临时关闭本地防火墙、VPN或代理工具,这类程序可能拦截WebSocket连接,导致HMR失效。
内容的提问来源于stack exchange,提问作者Djf
相关产品推荐
相关产品推荐

