React部署Vercel后Heroku后端生产环境接口调用失败,开发环境正常
故障根源定位
现有代码的逻辑缺陷直接导致了生产环境功能失效:
- 前端发起请求时使用的相对路径
/allPlans,完全依赖本地开发服务器的代理规则才能正常工作:在localhost:3000运行开发服务时,配置的dev server代理会自动把这类相对路径的请求转发到独立部署的Heroku后端,因此本地测试可以正常返回预期的数组数据。 - 部署到Vercel生产环境后,不存在本地dev服务器的代理转发逻辑,浏览器会把
/allPlans这类相对路径请求,直接解析为当前前端部署域名下的同路径地址,也就是请求实际发给了Vercel的静态资源服务,根本没有触达你的Heroku后端接口,自然会返回Vercel的404类异常响应,和预期的接口数据完全不符。
落地修复方案
- 使用环境变量区分开发、生产环境的接口基础地址:不要在生产代码中硬编码相对路径,把后端接口的基础域名抽离为独立的环境变量:
- 开发环境下保持本地dev server代理配置不变,环境变量值留空,请求时走相对路径
- 生产环境下将环境变量值设置为Heroku后端的完整访问地址,请求时拼接成完整接口路径发起调用,对应代码逻辑为:
const API_BASE_URL = import.meta.env.VITE_API_BASE_URL; // 按项目实际使用的环境变量语法调整 const endPoint = `${API_BASE_URL}/allPlans`; let ret = await axios.get(endPoint);
- 如果需要规避跨域限制,可在Vercel项目的配置文件中添加路由重写规则,将指定前缀的请求(比如
/api/*)转发到Heroku后端地址,前端同步把请求路径调整为带该前缀的路径,即可在不暴露完整后端地址的前提下正常触达接口。
配套校验项
- 检查Heroku后端的CORS跨域配置,确保已授权Vercel前端域名的跨域访问权限,避免前端正确请求接口后被浏览器跨域规则拦截
- 确认Heroku的服务运行状态正常,免费版dyno因长期无请求进入休眠状态时,首次请求会出现冷启动延迟,可能导致前端请求超时返回异常
内容的提问来源于stack exchange,提问作者Anupam
相关产品推荐
相关产品推荐

