React前端本地localhost正常,部署至Vercel后出现白屏求助
前端部署Vercel后白屏求助
我的前端项目在localhost本地环境运行正常(可在仓库分支的codespace运行),但部署到Vercel后仅显示白屏,Vercel未给出任何报错信息,无法调试。已完成后端与数据库服务器的部署,仅需解决前端运行问题。
Vercel部署白屏截图:
本地运行正常截图:
排查方向建议
- 打开浏览器开发者工具(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
相关产品推荐
相关产品推荐

