Revel后端不托管Vue静态资源,需用Nginx/Caddy代理前端请求并反向代理API;必须显式处理CORS预检OPTIONS请求;Vue需统一配置API baseURL并与routes路径严格对齐;401需Vue端实现静默刷新与重试,且refresh接口须白名单放行。

Revel 后端不暴露静态资源,Vue 前端必须独立构建
Revel 默认把 public/ 目录作为静态文件根路径,但它**不托管 Vue 构建后的 index.html 和打包 JS/CSS**——它只服务 API,不充当前端服务器。这意味着你不能把 dist/ 直接扔进 public/ 然后指望 Revel 自动路由到单页应用入口。
常见错误现象:404 Not Found 访问 / 或 /dashboard,但 /api/users 能正常返回 JSON。
- 正确做法:用 Nginx 或 Caddy 代理前端请求(
/、/assets/)指向 Vue 构建目录,同时将/api/、/auth/等前缀反向代理到 Revel 启动的后端地址(如http://localhost:9000) - 开发阶段可跳过 Nginx,直接在 Vue 项目中配
vite.config.ts的server.proxy,把/api/指向 Revel 的localhost:9000 - Revel 的
app.conf中无需开启static.dir或修改static.prefix来“适配” Vue;它本来就不是干这个的
Revel 的 CORS 配置容易漏掉 OPTIONS 预检响应
Vue 发送带认证头(Authorization)或非简单 Content-Type(如 application/json)的请求时,浏览器会先发一个 OPTIONS 请求。Revel 默认不处理该方法,导致跨域失败且控制台只显示 net::ERR_FAILED,没有明确错误提示。
解决方式不是加个中间件就完事——必须显式允许 OPTIONS 方法并返回正确头:
立即学习“前端免费学习笔记(深入)”;
- 在 Revel 的
app/init.go中注册全局拦截器,对所有OPTIONS请求直接return nil并设置响应头:Access-Control-Allow-Origin、Access-Control-Allow-Methods、Access-Control-Allow-Headers - 别依赖第三方 CORS 包(如
revel-cors),很多版本不处理预检,或默认禁用OPTIONS - 开发时若用 Vite 代理,该问题不出现;但上线后走真实域名 + Nginx 代理时,CORS 必须由 Revel 层兜底
Vue 调用 Revel 接口时,baseURL 和路径前缀要严格对齐路由定义
Revel 的路由是声明式定义在 conf/routes 文件里的,比如这一行:POST /api/login App.Login。Vue 里如果写成 axios.post('/login') 或 axios.post('http://localhost:9000/api/login'),看似合理,实则埋雷。
- 推荐做法:在 Vue 中统一用环境变量定义
VUE_APP_API_BASE_URL,开发时为''(空字符串,靠代理),生产时为'https://yourdomain.com/api';所有请求都拼接该前缀 - Revel 的
conf/routes中路径必须以/api/开头,否则前后端路径约定断裂,Nginx 无法按前缀分流 - 特别注意:Revel 的
GET /api/users/:id对应 Vue 中应为get(`/users/${id}`),不要多写一个/api—— 因为 baseURL 已含
Revel 没有内置 Token 刷新机制,Vue 端需自己实现 401 拦截与重试
Revel 支持 JWT,但不像 Spring Security 那样自动拦截 401 并触发刷新流程。当 Vue 收到 401 Unauthorized 时,如果只是跳转登录页,用户正在编辑的表单数据就丢了。
真正需要的是“静默刷新 + 请求重放”,这得 Vue 自己扛:
- 用 axios 的
interceptors.response.use捕获 401,调用/api/auth/refresh获取新 token - 刷新成功后,把原始失败请求从队列里取出,用新 token 重新发起(注意避免死循环)
- Revel 后端必须提供
/api/auth/refresh接口,且要求传入旧 refresh token,校验后签发新 access token —— 这个逻辑不会自动生成,得手写 - 别把 refresh token 存 localStorage;Revel 的 session 默认用 cookie,建议设
HttpOnly,Vue 只管发请求,不碰 token 字符串
最常被忽略的是:Revel 的 FilterConfig 里若没把 /api/auth/refresh 加入白名单,该接口本身就会被鉴权 filter 拦住,导致刷新链路直接断裂。


















