Beego中Session未生效主因是初始化顺序错误：beego.BConfig.WebConfig.Session.SessionOn = true必须在beego.Run()前顶层执行，且conf/app.conf中sessionon = true后不可有任何注释。
Beego 运行报错，90% 的问题出在初始化顺序、模块依赖或配置加载时机上，不是代码逻辑本身。
beego.BConfig.WebConfig.Session.SessionOn = true 但 session 还是 nil
这是典型的配置未生效现象，不是代码写错了，而是 SessionOn = true 被执行得太晚——Beego 在 beego.Run() 内部会提前初始化 Session 模块，如果此时 SessionOn 还是默认的 false，后续再设为 true 就无效了。
- 必须在
beego.Run()之前设置，且不能放在任意函数里（比如某个 init() 或子函数中），要确保它在 main 包顶层、beego.Run()直接前执行 -
conf/app.conf中的sessionon = true后面**不能有任何注释**，哪怕一个空格或#都会导致解析失败，变成未开启状态 - 如果用的是 Beego v2，确认导入的是
github.com/beego/beego/v2/server/web，而不是旧版github.com/astaxie/beego，否则配置字段可能不匹配
bee run 报 missing go.sum entry for module
Go 1.13+ 默认启用 modules，但项目里 go.mod 缺少对应依赖条目，或 go.sum 没同步更新，导致编译器找不到包提供者。
- 先运行
go mod tidy，它会自动补全go.mod并生成/更新go.sum - 如果提示 “no required module provides package”，说明 import 路径和本地模块名不一致，检查
go.mod第一行的 module 名是否和import _ "your-module/routers"中的路径完全一致（包括大小写） - 别用
go get github.com/beego/beego/v2手动拉包——v2 的子包结构变了，应直接go mod tidy让工具自动解析依赖树
路由 404 但控制器方法明明存在
不是路由写错了，而是 Beego 的路由注册机制没触发。Beego 依赖 routers/init.go 里的 init() 函数自动调用 beego.Router()，而这个函数只有被显式导入时才会执行。
- 确认
routers/router.go被空白导入：在main.go或测试文件顶部加import _ "your-module/routers"（路径必须和go.mod中 module 名一字不差） - 检查控制器 struct 名是否首字母大写（如
MainController），小写名称不会被 Beego 自动识别 - 检查
import语句是否指向远程路径（比如github.com/xxx/project/controllers），克隆项目后要改成本地相对路径（如example/controllers）
CORS 配置了但浏览器仍报跨域错误
Beego 的 CORS 中间件对 OPTIONS 预检请求支持很弱，尤其当 AllowCredentials: true 和 AllowAllOrigins: true 同时出现时，浏览器会直接拒绝响应，连 OPTIONS 都不发。
- 删掉
AllowAllOrigins: true，改用显式列表：AllowOrigins: []string{"http://localhost:5173", "https://myapp.com"} - 必须手动注册 OPTIONS 路由，例如：
beego.Router("/api/user", &controllers.UserController{}, "options:GetOptions")，不然预检永远 405 -
AllowHeaders要包含前端实际发送的头，比如"Authorization"，不能只写"*"；大小写敏感，写成"authorization"在某些中间件下会失效
最常被忽略的一点：Beego v2 的日志默认不输出 panic 堆栈，遇到崩溃类错误（比如 nil pointer dereference），要在 conf/app.conf 加 loglevel = 3 并确保 logs 包已正确导入，否则你看到的只是“Handler crashed”，根本不知道哪一行崩的。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
