Gin框架路由注册要求处理器为func(gin.Context)类型，结构体方法因隐含接收者不能直接传入；必须通过已实例化的指针调用（如uc.Index）或匿名函数包装（func(c gin.Context){uc.Index(c)}）才能正确绑定。
Go 语言中 Gin 框架本身不强制定义“控制器”概念，但你用结构体方法做路由处理器时，router.GET 等绑定的必须是符合 func(*gin.Context) 类型的函数——结构体方法本身不是函数，不能直接传入；必须显式调用构造器或使用匿名函数包装，否则会编译失败或 panic。
为什么 userController.Index 不能直接传给 router.GET
Gin 的路由注册函数（如 GET、POST）只接受 gin.HandlerFunc 类型，也就是 func(*gin.Context)。而结构体方法 (uc *UserController) Index(c *gin.Context) 是一个「方法值」，它隐含接收者，类型不是函数，不能直接赋值。
常见错误现象：
- 写成
userRoutes.GET("", userController.Index)→ 编译报错：cannot use userController.Index (type func(*gin.Context)) as type gin.HandlerFunc（实际错误信息更可能是类型不匹配，因方法值未绑定接收者） - 写成
userRoutes.GET("", UserController.Index)（未实例化）→ 编译失败：方法必须通过实例调用
正确做法是显式绑定接收者，有两种等效方式：
立即学习“go语言免费学习笔记（深入）”；
-
userRoutes.GET("", userController.Index)—— 前提是userController是已初始化的指针实例（如uc := &UserController{}），此时uc.Index是方法值，可自动转换为闭包函数 -
userRoutes.GET("", func(c *gin.Context) { userController.Index(c) })—— 手动包装，最直观，无歧义
admin.AdminController{}.Index 这种写法为什么能工作
这种写法本质是每次调用都新建一个临时结构体实例，并取其方法值。虽然看起来像“无状态调用”，但它依赖 Go 对方法值的隐式转换支持。
关键点：
-
admin.AdminController{}是一个零值实例（非 nil 指针），只要方法不依赖字段状态（比如没读c.ID或其他成员变量），就能安全使用 - 如果方法内部用了接收者字段（如
c.db、c.logger），必须用指针初始化（&admin.AdminController{...}），否则字段为零值，逻辑失效 - 性能上无明显开销，但语义上不如复用单例清晰；若控制器含依赖（如 DB 实例），推荐提前初始化并复用
结构体方法绑定时最容易忽略的 receiver 类型问题
接收者类型决定方法能否被正确绑定，且影响字段可访问性：
- 用值接收者
func(c AdminController) Index(...)：方法内修改c字段不会影响原实例；适合无状态、纯逻辑方法 - 用指针接收者
func(c *AdminController) Index(...)：能读写结构体字段，也允许在方法内保存状态（如缓存、DB 连接）；绝大多数场景应优先选指针 - 混用风险：若结构体同时有值接收者和指针接收者方法，Gin 路由绑定时可能因类型不一致导致编译错误或运行时 panic
例如，若 Index 是指针接收者，但你传的是 AdminController{}（值），Go 不会自动取地址，绑定失败。
绑定路径参数、查询参数时，控制器方法里怎么取值
结构体方法里仍需通过 *gin.Context 取参，和普通 handler 完全一致；绑定规则不因是否“控制器”而改变：
- 路径参数：
c.Param("id")（对应/user/:id） - 查询参数：
c.Query("page")或c.DefaultQuery("size", "10") - JSON 请求体：
c.ShouldBind(&req)，其中req是局部变量，无需挂到结构体上 - 不要试图把参数“自动注入”到控制器字段里——Gin 不提供这种机制；每次请求都是新
*gin.Context，控制器实例通常是共享的
容易踩的坑：有人误以为 ShouldBindUri 会自动填充结构体字段，其实它只是把 URI 参数绑定到传入的 struct 指针，仍需手动调用，且字段 tag 必须带 uri:"xxx"。
真正复杂的地方在于：控制器不是 Gin 的一等公民，所有“控制器感”都靠代码组织模拟出来；一旦开始依赖接收者字段传依赖（DB、Cache、Logger），就必须确保初始化方式统一、生命周期可控——这点比绑定语法本身更易出错。
