You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

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中添加配置关闭热模块替换,验证页面是否能正常显示:
    module.exports = {
      hotReload: false
    }
    
    若页面恢复正常,说明HMR模块存在异常,可尝试更新Next.js版本解决。
  • 排查防火墙/代理:临时关闭本地防火墙、VPN或代理工具,这类程序可能拦截WebSocket连接,导致HMR失效。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.07.06 23:28:09