iris 的 ctx.params().get 系列方法不支持默认值，路径缺参会导致路由不匹配而无法进入 handler；需通过注册多条路由（如 /user 和 /user/{id:uint64}）并在 handler 中统一判断参数是否为空来实现逻辑默认值。
ctx.Params().Get* 系列方法不支持默认值
Iris 的 ctx.Params() 本身没有类似 GetDefault 的参数默认值机制——它只负责从已匹配的路径中提取值，而「路径未提供该参数」在 Iris 中属于路由不匹配，根本不会进到 handler。所以你不能指望 ctx.Params().Get("id") 在 /user/（缺 id）时返回默认值；它压根不会被这个路由捕获。
用可选路径段 + 宏类型组合实现“逻辑默认值”
真正可行的方式是把参数设为可选，并在路由定义中用宏约束其格式，再在 handler 内部做 fallback 判断。Iris 不支持 {id:uint64?} 这种语法，但可以用两个路由覆盖同一逻辑：
-
app.Get("/user", userHandler)—— 无参数版本，视为请求“默认用户” -
app.Get("/user/{id:uint64}", userHandler)—— 带强类型参数版本
然后在 userHandler 里统一判断：
func userHandler(ctx iris.Context) {
idStr := ctx.Params().Get("id")
if idStr == "" {
// 走默认逻辑，比如查用户 ID = 1
renderUser(ctx, 1)
return
}
id, err := strconv.ParseUint(idStr, 10, 64)
if err != nil {
ctx.StatusCode(400)
ctx.WriteString("invalid id format")
return
}
renderUser(ctx, id)
}
别误用 ctx.URLParam() 或 query 参数模拟默认值
有人试图用 ctx.URLParam("id")（取 ?id=123）配合路径参数混用，这是危险的信号：
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
-
ctx.URLParam()和ctx.Params()来源完全不同：前者是查询字符串，后者是路径段 - 如果同时允许
/user/123和/user?id=123，语义就模糊了，API 难以维护 - 更严重的是，
/user?id=abc会绕过{id:uint64}的路由宏校验，导致后续解析 panic
要保持接口清晰，就坚持一个入口：路径参数走 ctx.Params()，查询参数走 ctx.URLParam()，不交叉。
宏校验失败时无法 fallback，必须靠路由拆分
像 {id:int min(1)} 这类宏只做匹配拦截，不提供“转换失败就用默认值”的能力。一旦路径是 /user/0，Iris 直接 404，handler 根本不执行。所以「默认值」不是靠宏兜底，而是靠多注册一条更宽泛的路由来承接那些“没给参数”或“参数不符合强约束”的请求场景。
最易忽略的一点：别在 handler 里写 if id == 0 { id = 1 } 就以为实现了默认值——这掩盖了路径设计缺陷。真正的默认行为应该由路由结构表达，而不是靠运行时补救。
