beego.NSNamespace 是路由前缀分组，需配合 NSInclude 才生效，路径自动拼接前缀，嵌套建议≤2层；控制器须传指针，Filter 在路由匹配后执行，注解路由仅 dev 模式生效且依赖正确生成。
beego.NSNamespace 本质是路由前缀分组，不是独立服务
Namespace 在 beego 中只是对一组路由做路径前缀封装和中间件隔离，并不会启动新服务或改变请求生命周期。它不等价于微服务的 namespace，也不影响 HTTP 状态码、响应头等底层行为。
常见错误现象：beego.NSNamespace("/v1", ...) 注册后，访问 /v1/users 返回 404，但 /users 能通——说明 Namespace 没生效，大概率是漏掉了 beego.NSInclude 或嵌套层级错位。
- 必须配合
beego.NSInclude才能真正注册子路由，单独写beego.NSNamespace不会自动挂载 - 所有子路由的 path 都会自动拼上前缀，比如
NSNamespace("/api")+NSRouter("/users", ...)最终匹配的是/api/users，而非/users - Namespace 可以嵌套，但嵌套过深（>3 层）会导致路由表生成慢、调试困难，建议控制在 2 层以内
NSInclude 里控制器必须显式传入指针，不能传值或 nil
你写 &controllers.UserController{} 是对的，但写 controllers.UserController{} 或 nil 会导致运行时 panic，错误信息类似 reflect: Call of nil Value.Call。
使用场景：当你想复用同一控制器的不同实例（比如带不同 DB 连接），必须确保每个实例都是独立指针，且不能在 NSInclude 外部提前初始化并复用同一个指针——Beego 内部会多次调用其方法，共享指针可能引发并发读写冲突。
-
NSInclude接收的是[]interface{}，所以可以传多个控制器指针，如NSInclude(&c1{}, &c2{}) - 如果控制器需要依赖注入（如传入 config 或 logger），应在
Init()方法里处理，而不是构造函数——Beego 不调用自定义构造函数 - 别在
NSInclude里传匿名结构体或闭包，Beego 无法识别其方法集
Namespace 中间件 Filter 的执行时机比 Controller 更早
Filter 在 Namespace 级别注册时，会在路由匹配成功后、进入 Controller 前执行，但它**不拦截未匹配的路径**。也就是说，/admin/xxx 匹配失败时，NSNamespace("/admin", ...) 里的 Filter 根本不会运行。
参数差异：NSBefore / NSAfter / NSFinally 对应请求生命周期不同阶段，但它们共享同一个 context.Context，变量可跨阶段传递；而 Controller 内的 c.Data 是独立作用域，Filter 里设的值默认不会透传过去，除非手动塞进 ctx.Input.Data。
-
NSBefore最适合做权限校验、请求日志、Header 解析 -
NSAfter适合统一加 Header、记录耗时，但注意此时 response body 可能已写出，不能再调用ctx.Output.Body() -
NSFinally总会执行，可用于清理资源（如关闭临时文件句柄），但无法修改响应内容
dev 模式下注解路由（@router）与 Namespace 共存时的优先级陷阱
当同时启用注解路由（@router /user [get]）和 Namespace（NSNamespace("/api")），最终注册的路径是 /api/user，但前提是注解路由必须写在 NSInclude 包含的控制器内，且 runmode = dev 已开启——否则 commentsRouter_controllers.go 不会生成，注解被完全忽略。
容易踩的坑：@Param 里的 path 和 query 类型必须和实际 URL 结构一致。比如写了 @Param id path int true "id"，但请求是 /api/user?id=123，c.Ctx.Input.Param(":id") 就会返回空字符串，而不是报错。
- 注解路由只在
dev模式下扫描生成，生产环境必须靠bee pack或手动复制生成的commentsRouter_*.go文件，否则路由丢失 - Namespace 内部若混用
NSRouter和注解路由，建议统一风格，避免调试时路由表来源混乱 - 注解中的
[get]必须小写，写成[GET]或[Get]都会导致解析失败，且无提示
bee run -d 查看启动日志里是否打印了对应路由，再 curl 测试，别依赖“看起来写了就对了”。 
