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

React前端本地localhost正常,部署至Vercel后出现白屏求助

前端部署Vercel后白屏求助

我的前端项目在localhost本地环境运行正常(可在仓库分支的codespace运行),但部署到Vercel后仅显示白屏,Vercel未给出任何报错信息,无法调试。已完成后端与数据库服务器的部署,仅需解决前端运行问题。

Vercel部署白屏截图:
Vercel部署的frontend显示白屏截图

本地运行正常截图:
localhost本地运行的frontend截图

排查方向建议

  • 打开浏览器开发者工具(F12),查看Console标签页的JS报错,以及Network标签页的资源加载/API请求状态,多数白屏由资源加载失败、JS执行报错或API请求异常导致。
  • 检查Vercel项目的构建配置:确认框架预设选择正确,build命令、输出目录与本地一致;本地用到的环境变量需同步配置到Vercel的「Settings -> Environment Variables」中。
  • 若为单页应用(SPA),需确保Vercel配置了fallback路由:比如React项目指定public/index.html为入口,Vue项目指定dist/index.html作为fallback,否则直接访问子路由或刷新页面会触发404导致白屏。
  • 查看Vercel的构建日志:在项目的Deployments标签页点击对应部署记录,查看Build Logs,排查是否有依赖安装失败、构建命令执行异常的情况。
  • 本地模拟生产环境:执行npm run build(对应框架的构建命令),用本地服务器(如npx serve dist)运行构建产物,验证是否能正常访问,排除构建产物本身的问题。

内容的提问来源于stack exchange,提问作者JOHN EDWARD BINAY

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.08.08 10:15:11