Beego托管Vue dist目录需用InsertFilter在BeforeRouter阶段拦截非API请求并返回index.html，同时配置CORS允许凭据与正确请求头、启用session且设置cookie路径，确保history模式刷新不404、跨域正常、登录态持久。
Beego 后端直接 serve Vue 构建产物是可行的，但必须绕过 API 路由、正确处理 history 模式跳转，否则刷新 404；跨域、静态资源路径、Session 传递这三处最容易出问题。
Beego 如何托管 Vue 的 dist 目录并支持 history 模式
Vue Router 使用 history 模式时，前端路由无 #，所有路径都需被 Beego 捕获并返回 index.html，但不能干扰真实 API 请求（如 /api/v1/users）。
- 用
beego.InsertFilter在BeforeRouter阶段拦截所有请求，优先判断是否含api、static、favicon.ico等关键词，匹配则直接放行 - 未匹配的路径统一指向
static/dist/index.html，用http.ServeFile返回（不是重定向） -
static/dist/必须是 Vue 构建后的真实输出路径，且 Beego 的StaticDir配置要与之对齐，否则 CSS/JS 404 - 不要用
beego.SetStaticPath替代该逻辑——它不处理 history 回退，只服务已知文件
Beego 跨域配置必须匹配 Vue 的请求头
Vue 前端若用 axios 或封装的 request 发送带凭证的请求（如登录态 Session），Beego 的 CORS 插件必须显式开启 AllowCredentials: true，且 AllowHeaders 必须包含前端实际发送的字段。
- 前端常见请求头：
X-Requested-With、Content-Type、Authorization、X-Token，漏一个就会触发预检失败（OPTIONS403） - Beego 中启用插件需 import
"github.com/astaxie/beego/plugins/cors"，并在init()里调用beego.InsertFilter -
AllowAllOrigins: true仅用于开发；生产环境应限定AllowOrigins为具体域名（如https://admin.example.com） - 务必确认
app.conf中copyrequestbody = true，否则 POST/PUT 的 body 在中间件中不可读
Vue 登录态如何在 Beego 中可靠维持
前后端分离下，Beego 默认的 Session 机制仍可用，但必须确保 Cookie 正确透传：Vue 请求要带 withCredentials: true，Beego 要允许凭据且不屏蔽第三方 Cookie。
使用 `@ainative/vue-sdk` 为 Vue 3 应用添加 AI 聊天功能。适用于以下场景：(1) 安装 `@ainative/vue-sdk`，(2) 在 Vue 组件中使用 `useChat` 组合式函数，(3) 提供……
立即学习“前端免费学习笔记（深入）”；
- 前端 axios 实例需全局设置：
defaults.withCredentials = true；单独请求也要显式写{ withCredentials: true } - Beego 的
sessionon = true必须在app.conf中启用，且sessionprovider = memory（开发）或redis（生产） - 登录成功后，Beego 用
c.SetSession("user_id", uid)写入；后续接口用c.GetSession("user_id")读取，无需手动解析 Cookie - 注意：若部署在子路径（如
/admin/），需设sessioncookiepath = "/admin"，否则 Cookie 不会被携带
构建与部署时路径和 API 基地址容易错位
Vue 的 vue.config.js 中 publicPath 和 Beego 的 API 基路径不一致，会导致请求发到错误域名或子路径。
- 开发时 Vue 通常走本地
http://localhost:8080，API 代理到http://localhost:8081，此时vue.config.js的devServer.proxy必须指向 Beego 地址 - 生产构建时，
publicPath应设为"./"（相对路径）或完整 CDN 地址；若 Beego 托管前端，则保持"./"即可 - API 请求基地址建议抽成环境变量：
VUE_APP_API_BASE = "/api"，前端代码中拼接process.env.VUE_APP_API_BASE + "/users" - Beego 路由注册必须严格匹配该前缀，例如
beego.Router("/api/users", &controllers.UserController{}, "get:GetUsers")
history 模式 fallback、CORS 头白名单、Session Cookie 的 path/domain 设置，这三个点一旦配置错，现象都是“看起来能登录，但一刷新就掉线”或“列表空着不报错”，排查时优先查 Network 面板里的 Request Headers 和 Response Headers。
