From 58fd877ae269cb7ca3799fc8f5b2c3fa4f5aaec5 Mon Sep 17 00:00:00 2001
From: wjqserver <114663932+WJQSERVER@users.noreply.github.com>
Date: Tue, 21 Apr 2026 18:32:10 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E4=BF=AE=E5=A4=8D=E5=AE=A1=E6=9F=A5?=
 =?UTF-8?q?=E6=84=8F=E8=A7=81=EF=BC=8C=E7=BB=9F=E4=B8=80=E6=9C=AF=E8=AF=AD?=
 =?UTF-8?q?=E5=B9=B6=E8=A1=A5=E5=85=85=E6=B3=A8=E5=86=8C=E9=A1=BA=E5=BA=8F?=
 =?UTF-8?q?=E8=AF=B4=E6=98=8E?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 补充中间件注册顺序说明（必须在路由定义之前）
- 统一术语：'组中间件' → '路由组中间件'
- 统一流程图术语
---
 docs/middleware.md | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/docs/middleware.md b/docs/middleware.md
index 14c75d6..b688fb5 100644
--- a/docs/middleware.md
+++ b/docs/middleware.md
@@ -104,7 +104,7 @@ func APIKeyAuth() touka.HandlerFunc {
 
 ## 中间件执行顺序
 
-理解中间件的执行顺序对于构建正确的处理流程至关重要。中间件按照以下顺序执行：
+理解中间件的执行顺序对于构建正确的处理流程至关重要。**注意：注册顺序决定了执行逻辑**，中间件必须在注册路由之前调用（全局中间件应在创建组或定义路由前注册）。中间件按照以下顺序执行：
 
 ```go
 // 全局中间件
@@ -122,14 +122,14 @@ api.GET("/users", RouteMiddleware1(), RouteMiddleware2(), userHandler)
 对于 `/api/users` 请求，执行顺序为：
 1. `GlobalMiddleware1()` - 全局中间件
 2. `GlobalMiddleware2()` - 全局中间件
-3. `GroupMiddleware1()` - 组中间件
-4. `GroupMiddleware2()` - 组中间件
+3. `GroupMiddleware1()` - 路由组中间件
+4. `GroupMiddleware2()` - 路由组中间件
 5. `RouteMiddleware1()` - 路由级中间件
 6. `RouteMiddleware2()` - 路由级中间件
 7. `userHandler` - 最终处理函数
 
 ```
-请求进入 → 全局中间件 → 组中间件 → 路由中间件 → 处理函数 → 路由中间件后置逻辑 → 组中间件后置逻辑 → 全局中间件后置逻辑 → 响应
+请求进入 → 全局中间件 → 路由组中间件 → 路由级中间件 → 最终处理函数 → 路由级中间件后置逻辑 → 路由组中间件后置逻辑 → 全局中间件后置逻辑 → 响应
 ```
 
 ## 内置中间件