如何在 Echo 框架中正确测试依赖 JWT 中间件的处理器

夜伟大大_7335

夜伟大大_7335

2026-11-02

133人浏览

原创

如何在 Echo 框架中正确测试依赖 JWT 中间件的处理器

在 Echo 单元测试中,c.Get("user") 返回 nil 是因未显式执行 JWT 中间件所致;需手动链式调用中间件函数、处理器函数与 Context,才能模拟真实请求流程并使 c.Get() 正常注入用户信息。

在 echo 框架中,`c.get("user")` 返回 `nil` 是因未显式执行 jwt 中间件所致;需手动链式调用中间件函数、处理器函数与 context,才能模拟真实请求流程并使 `c.get()` 正常注入用户信息。

Echo 的中间件(如 middleware.JWTWithConfig)本质是高阶函数:它接收配置后返回一个 echo.MiddlewareFunc,该函数再接收一个 echo.HandlerFunc 并返回一个新的、已包装的处理器。在集成测试中,若未启动 HTTP 服务器,就必须手动触发这一完整调用链,否则中间件逻辑(如解析 JWT、将 *jwt.Token 存入 c.Set("user", token))根本不会执行,导致 c.Get("user") 始终为 nil。

正确的测试写法是将中间件、目标处理器和测试 Context 按顺序组合调用:

// ✅ 正确:显式执行中间件链
middleware.JWTWithConfig(middleware.JWTConfig{
    SigningKey: []byte("secret"), // 注意:TokenLookup 默认为 "header:Authorization",无需额外设 query:user
})(Logout(db, Models.Redis))(c)

⚠️ 关键注意事项:

Miller CSV TSV JSON 数据处理器
Miller CSV TSV JSON 数据处理器

Miller (mlr) 是一个命令行工具,用于查询、整形和重新格式化名称索引数据,如 CSV、TSV、JSON 和 JSON Lines。它将 awk、sed、cut、join 和 sort 的功能整合到一个专为结构化数据处理而构建的单一工具中。

下载
  • TokenLookup 配置需与实际请求头匹配:原代码中 TokenLookup: "query:user" 表示从 URL 查询参数 ?user=xxx 提取 token,但测试中却通过 Authorization: Bearer xxx 传入——这会导致解析失败。应统一使用标准 Authorization 头(默认行为),或同步调整测试请求(如 req.URL.RawQuery = "user=" + Token)。
  • 中间件必须在 handler 之前执行:e.Use(...) 仅在 e.Start() 启动服务器时生效;单元测试中需手动调用,不可省略。
  • c.Get("user") 的值由中间件设置:JWT 中间件成功验证后会自动调用 c.Set("user", token),因此只有完整执行中间件链,c.Get("user") 才非空。

完整可运行的测试片段如下:

func TestLogout(t *testing.T) {
    loadConfig()
    db := stubDBs(t)
    Convey("When you post to /logout", t, func() {
        Convey("with a valid token, you should get a success msg and be logged out", func() {
            e := echo.New()
            req, err := http.NewRequest(echo.POST, "/auth/logout", nil) // 路径建议带前缀 /
            if err != nil {
                t.Fatal(err)
            }
            req.Header.Set(echo.HeaderAuthorization, "Bearer "+Token) // 确保 Token 有效且签名密钥一致

            rec := httptest.NewRecorder()
            c := e.NewContext(req, rec)

            // ? 核心:手动触发 JWT 中间件 → 注入 Logout 处理器 → 执行 Context
            middleware.JWTWithConfig(middleware.JWTConfig{
                SigningKey: []byte("secret"),
                // TokenLookup 默认为 "header:Authorization",无需显式设置
            })(Logout(db, Models.Redis))(c)

            // 断言响应
            body := GetJsonBody(rec.Body.String())
            So(rec.Code, ShouldEqual, http.StatusOK)
            So(body.Path("error").Data(), ShouldBeNil)
            So(body.Path("msg").Data().(string), ShouldEqual, "Logged Out")
            So(body.Path("data.user.password").Data().(string), ShouldEqual, "")
            So(body.Path("data.user.token").Data(), ShouldBeNil)
        })
    })
}

总结:Echo 测试不是“构造请求+调用 handler”,而是“构造中间件链+注入 handler+执行 Context”。理解 MiddlewareFunc 的函数签名 func(echo.HandlerFunc) echo.HandlerFunc 是解决此类问题的关键。始终确保测试环境中的 token 解析路径、密钥、算法与生产环境完全一致,才能让 c.Get("user") 行为一致。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

处理器

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
Uvicorn 报错与问题解决教程
Uvicorn 报错与问题解决教程

本专题汇总了Uvicorn服务器常见问题与报错解决的教程合集,涵盖启动失败、端口占用、模块导入错误、事件循环冲突及热重载失效等典型故障的排查思路。同时整理了多进程与Worker配置、SSL/HTTPS证书报错、跨域与代理配置等实战解决方案,助你快速定位并解决Uvicorn运行中的各类问题。

2026.11.02

0

14

Uvicorn使用教程
Uvicorn使用教程

本专题汇总了Uvicorn使用教程与启动运行指南,涵盖其作为Python ASGI服务器的定位与特点,以及命令行启动(uvicorn main:app --reload)、参数配置(host/port/workers)、程序内嵌运行与Gunicorn结合部署等核心用法。同时整理了热重载调试、日志配置与生产环境部署优化等技巧,助你快速掌握Uvicorn的运行与配置。

2026.11.02

0

17

Uvicorn安装配置教程
Uvicorn安装配置教程

本专题汇总了Uvicorn的安装配置教程与部署指南,涵盖通过pip安装Uvicorn、启动FastAPI/Starlette应用、开发模式热重载(--reload)及多进程工作模式配置等核心操作。同时整理了结合Gunicorn的生产部署方案、HTTPS与反向代理配置及性能调优技巧,助你快速完成Uvicorn服务的安装与上线部署。

2026.11.02

0

17

Vite 项目如何打包和部署
Vite 项目如何打包和部署

Vite项目打包部署专题汇集生产构建、产物预览、输出目录、资源路径、Nginx与GitHub Pages部署及常见白屏和路由404问题的已审核文章,帮助读者完成上线流程。

2026.10.28

100

16

Vite 如何搭配 Vue.js
Vite 如何搭配 Vue.js

Vite搭配Vue.js专题汇集创建Vue 3项目、配置开发环境、路径别名、Vue插件、代理、多环境构建与调试的已审核文章,帮助读者完成从初始化到日常开发的配置。

2026.10.28

80

15

Vite 项目目录怎么看
Vite 项目目录怎么看

Vite项目目录专题汇集入口文件、src源码、public静态资源、路径别名、项目根目录和构建输出目录相关的已审核文章,帮助读者理解各文件夹的用途与引用方式。

2026.10.28

240

10

Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

2026.10.22

140

11

Gradle Wrapper配置教程
Gradle Wrapper配置教程

本专题介绍Gradle Wrapper的基本作用,涵盖文件组成、生成方法、版本配置和任务调用,帮助你理解项目如何使用指定的Gradle版本,减少不同开发环境带来的构建差异。

2026.10.22

140

10

Golangci-lint检查器使用教程
Golangci-lint检查器使用教程

本专题整理Golangci-lint常用Linters的用途与配置方法,覆盖错误处理、无效代码、安全、复杂度、命名和依赖检查,帮助项目合理选规则。

2026.10.22

100

15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Sass 教程
Sass 教程

共14课时 | 1.6万人学习

PHP入门速学(台湾同胞版)
PHP入门速学(台湾同胞版)

共10课时 | 1.6万人学习

韩顺平 2016年 最新PHP基础视频教程
韩顺平 2016年 最新PHP基础视频教程

共47课时 | 12.2万人学习