如何使用Vercel配置代理?配置API代理时返回404错误如何解决
404 根因拆解
- 配置存在标准JSON语法错误:你写的规则对象里,最后一个属性后面多了尾逗号(trailing comma)。Vercel 对
vercel.json做严格JSON校验,遇到非法语法会直接放弃加载所有自定义路由规则,最终返回默认404响应。 - 路由类型选错:你要的是服务端代理(前端请求路径不变,Vercel 服务器帮你转发请求到第三方API,透传响应),但用了
redirects配置。redirects本质是3xx重定向,会直接给浏览器发跳转指令,让浏览器自己去访问第三方API地址,不是服务端代理。 - 规则匹配顺序冲突:你写了一条全量兜底的rewrite规则
/(.*) -> /index.html,如果API代理规则没有放在数组更靠前的位置,会被这条兜底规则提前拦截,根本走不到代理逻辑。
可正常运行的修正配置
{ "rewrites": [ { "source": "/api/test.json", "destination": "https://myapi.com/test.json" }, { "source": "/(.*)", "destination": "/index.html" } ] }
配置生效逻辑
- 删掉所有规则里的尾逗号,保证JSON格式合法,Vercel 能正常解析配置
- 把API代理规则挪到
rewrites块,并且放在全量兜底规则的前面——Vercel 会按数组顺序从上到下匹配路由,命中第一条符合的规则就停止后续匹配,把API规则放前面就能保证请求/api/test.json时先命中代理逻辑,而不是走前端路由兜底 - 配置生效后,前端请求
/api/test.json时,Vercel 会在服务端转发请求到https://myapi.com/test.json,把响应直接返回给前端,全程不会改变浏览器地址栏的路径,也不会触发跨域限制。
实用扩展:如果要代理所有
/api/开头的接口,不用逐个写规则,直接把source改成/api/:path*,destination对应改成https://myapi.com/:path*,就能一次性匹配全部API路径。
内容的提问来源于stack exchange,提问作者ridermansb
相关产品推荐
相关产品推荐

