beego路由配置需按控制器结构、参数需求和维护成本选择：beego.Get/Post是语法糖，仅适用单函数场景；beego.Router才是RESTful控制器标准入口，支持多方法映射与类型约束；beego.AddAuto依赖反射且要求控制器已加载、方法首字母大写、签名规范。
beego 的路由配置不是“选一种方式就行”，而是得根据控制器结构、参数需求和维护成本来选——用错方式，轻则 405 Method Not Allowed，重则路由完全不生效，连 beego.Router 都被当成普通字符串忽略。
beego.Get/Post 等快捷函数只适合单函数处理场景
它们是语法糖，内部调用 beego.Router 并强制绑定单一 HTTP 方法到闭包或函数。适合原型验证或极简接口（如健康检查）：
beego.Get("/health", func(ctx *context.Context) { ctx.Output.Body([]byte("ok")) })- 不支持路径参数提取以外的逻辑，比如
/user/:id:int类型约束在这里无效 - 不能复用控制器生命周期方法（如
Prepare()、Finish()），中间件挂载也受限 - 若你写了
beego.Post("/api/users", handler)，但前端发的是PATCH，直接 404 —— 它不 fallback 到其他方法
beego.Router 是 RESTful 控制器的正确入口
这才是绑定控制器的标准方式，也是绝大多数业务场景该用的。它默认按 HTTP 方法分发到控制器同名方法（Get()、Post() 等），但必须显式传参才能启用多方法支持：
在SEO发布前，从路由清单生成XML网站地图和robots.txt
下载
当代理已经知道网站路由或内容URL，并且在启动前需要有效的sitemap XML、sitemap索引或robots.txt引用时，请使用sitemap。这是一个发布构件技能，而不是爬虫或SEO平台。
- 错误写法：
beego.Router("/users/:id", &controllers.UserController{})→ 实际只响应GET，其他方法返回405 - 正确写法：
beego.Router("/users/:id", &controllers.UserController{}, "get:Get;post:Post;delete:Delete") - 类型约束必须带冒号前缀：
/users/:id:int才会校验数字；/users/:name:string匹配[\w]+，中文或短横线会直接跳过该路由（不是报错，是静默不匹配） - 如果控制器方法叫
Fetch()而非Get()，必须写成"get:Fetch"，否则不触发
beego.AddAuto 不是自动发现，而是按约定反射注册
它不会扫描文件系统或 import 路径，只对已加载的控制器 struct 生效。常见失效原因：
- 控制器定义在未被
import的包里（比如放在internal/下但没被 main 引用） - 方法首字母小写（如
getUser()），Go 反射无法导出，AddAuto直接跳过 - 方法签名不是
func(*context.Context)，比如多了返回值或参数 - 没加前缀时，路径映射严格按 struct 名小写转换：<code>UserController</code> →
/usercontroller，不是/users - 加前缀更安全：
beego.AddAutoPrefix("/api/v1", &controllers.UserController{})
子域名和 Host 头完全不在 beego 路由管辖范围内
beego.Router 的第一个参数永远是 Request.URL.Path，Host 字段从不参与匹配。所有“子域名路由”需求必须前置处理：
- 写
beego.Router("admin.example.com/users", ...)没用，框架收到的 Path 是/users - Nginx 必须先做分流，再把请求代理到 beego 实例（可同一端口，用路径前缀区分逻辑域）
- 若真要在 beego 内部做 Host 校验，只能手动读
c.Ctx.Request.Host，在Prepare()里判断并提前c.Ctx.Abort(404) - 别依赖
app.conf的httpaddr或httpport绑定域名 —— 它们只控制监听地址，不解析 Host
beego 不会尝试 fallback 到下一个规则，也不会打印警告日志。一个 :id:int 写错、一个方法名大小写不一致、一个控制器没被引用，结果都是静默 404 —— 你得靠 bee run -d 启动时看控制台输出的已注册路由列表，或者用 beego.BeeApp.Handlers.ShowAllHandlers() 主动打印。 
