如何在Iris框架中实现路由异常处理-Golang-PHP中文网

iris中controller返回error被忽略，错误响应须显式调用ctx.stopwithstatus()终止流程；单独statuscode()或json()无效，顺序错误会导致响应异常。

如何在iris框架中实现路由异常处理

必须手动中断，Iris不会自动拦截controller返回的error

在Iris中，Controller方法返回error值完全被忽略——框架既不捕获、也不响应。这意味着写return errors.New("xxx")或return fmt.Errorf("...")对HTTP状态码和响应体毫无影响。所有错误响应必须显式构造并终止执行流。

用`ctx.StopWithStatus()`强制终止请求

这是最可控、最推荐的方式。它明确设置状态码、写入JSON、并立即停止后续中间件和handler执行。

ctx.StatusCode()只设状态码，不阻断流程；必须配合ctx.StopWithStatus()
ctx.JSON()只序列化数据，不设状态码；若之前没调用StatusCode()，默认是200
ctx.StopWithStatus(400)必须紧跟ctx.JSON()之后，且后面要跟return，否则controller剩余逻辑仍会执行

示例：

Skill Weave Chains — 技能链路由引擎

开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。

下载

func (c *ProductController) Create(ctx iris.Context) {
    var req ProductReq
    if err := ctx.ReadJSON(&req); err != nil {
        ctx.StatusCode(400)
        ctx.JSON(BizError{Code: 40001, Msg: "参数解析失败"})
        ctx.StopWithStatus(400)
        return // ⚠️ 必须有
    }
    // ... 正常逻辑
}

用`panic(&BizError{})`触发recover捕获

适合快速兜底，但掩盖了控制流，调试困难，不建议在核心路径使用。

必须提前注册recover()中间件，且只捕获panic，对普通return error无效
BizError类型必须实现Error()方法，否则recover()拿到的是interface{}，无法类型断言
panic会跳过defer链中未执行的部分（如DB事务rollback），存在资源泄漏风险

中间件示例：

app.Use(func(ctx iris.Context) {
    defer func() {
        if r := recover(); r != nil {
            switch e := r.(type) {
            case *BizError:
                ctx.StatusCode(500)
                ctx.JSON(e)
            default:
                ctx.StatusCode(500)
                ctx.JSON(BizError{Code: 50000, Msg: "未知系统错误"})
            }
        }
    }()
    ctx.Next()
})