Beego中GetString/GetInt需显式调用并检查err，不自动绑定结构体；路由参数须用Param()获取，查询参数用GetString等；安全绑定需手动赋值+校验，推荐封装ParseQuery方法。
Beego 中 GetString 和 GetInt 的实际用法
Beego 不会自动把 URL 查询参数（如 ?name=alice&age=28）注入到结构体字段，必须显式调用参数获取方法。最常用的是 GetString、GetInt、GetBool 等，它们从 this.Ctx.Input 读取，且默认只读查询字符串（GET）和表单数据（POST body），不读路由参数（如 /user/:id）。
常见错误是直接写 this.GetString("name") 却没处理空值或类型转换失败，结果返回空字符串或 0，掩盖了真实缺失问题：
name := this.GetString("name")
if name == "" {
this.Abort("400") // 错误：空值可能是传了空字符串，也可能是根本没传
}
- 务必配合
err判断是否参数缺失：name, err := this.GetString("name")；若err != nil，说明参数未提供 -
GetInt对非数字值（如?age=abc）会返回0, err，不是静默忽略 - 所有
GetXXX方法都区分大小写，GetString("Name")拿不到?name=xxx
如何安全绑定多个 URL 参数到结构体
Beego 没有内置的结构体批量绑定（类似 Gin 的 BindQuery），得手动赋值 + 校验。推荐封装一个 ParseQuery 方法，避免每个 handler 重复写判断逻辑：
type UserQuery struct {
Name string `form:"name"`
Age int `form:"age"`
}
func (c *UserController) ParseQuery() (*UserQuery, error) {
q := &UserQuery{}
var err error
if q.Name, err = c.GetString("name"); err != nil {
return nil, errors.New("missing 'name'")
}
if q.Age, err = c.GetInt("age"); err != nil {
return nil, errors.New("invalid or missing 'age'")
}
return q, nil
}
- 结构体 tag 里的
form:"xxx"只是标记用途，Beego 不自动解析它；必须手写映射 - 不要在结构体字段上设默认值（如
Age int `form:"age"`默认为 0），否则无法区分“用户传了 0”和“根本没传” - 如果参数可选，字段类型应改用指针（
*int）或加额外标志字段，再配合GetXXX的err判断
URL 路径参数（:id）和查询参数（?q=）不能混用 GetXXX
this.GetString("id") 拿不到路由路径中的 :id —— 它只查 query 和 form。路径参数必须用 this.Ctx.Input.Param(":id") 单独取：
// 请求 /api/user/123?format=json
idStr := this.Ctx.Input.Param(":id") // → "123"
format := this.GetString("format") // → "json"
id, _ := strconv.Atoi(idStr) // 需手动转类型
-
Param返回的是字符串，不校验是否存在；若路由定义为/:id:int，Beego 会拦截非法值（如/user/abc直接 404），但不会帮你转成 int - 别把
Param和GetString搞混：前者专用于:xxx或:xxx:int这类路由占位符，后者只管 ? 后面的键值对 - 混合场景下（如
/user/:id?role=admin），两个来源要分开处理，不能期望一个方法覆盖全部
性能与边界：大量参数时注意拷贝和编码问题
每次调用 GetString 都会触发一次 url.ParseQuery（Beego 内部缓存了结果，所以多次调用同名参数不重复解析），但如果你手动调用 this.Ctx.Input.RequestBody 或反复访问 this.Ctx.Request.URL.Query()，可能绕过缓存，引发重复解析开销。
- 避免在循环里反复调用
GetString；先一次性取完所有需要的参数，再处理 - URL 参数值默认经过 URL decode，但 Beego 不校验 UTF-8 合法性；若前端传了乱码或截断的 UTF-8 字节，
GetString仍返回原始字节，后续len(str)或 JSON 输出可能出错 - 参数名含特殊字符（如点号
.、中括号[]）时，标准 HTTP 不支持，Beego 也不会做额外处理；这类需求应改用 JSON body 或自定义编码规则
URL 参数绑定看着简单，真正难的是在空值、类型错误、编码异常、路由混用这些边界上保持行为一致。别依赖“能跑就行”，每个 GetXXX 调用都要想清楚：它没拿到值时，你的业务逻辑到底该报错、跳过，还是给默认？
