docs: 修复审查意见,统一术语并补充注册顺序说明

- 补充中间件注册顺序说明(必须在路由定义之前)
- 统一术语:'组中间件' → '路由组中间件'
- 统一流程图术语
This commit is contained in:
wjqserver 2026-04-21 18:32:10 +08:00
parent fce12ee7e7
commit 58fd877ae2

View file

@ -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` - 最终处理函数
```
请求进入 → 全局中间件 → 组中间件 → 路由中间件 → 处理函数 → 路由中间件后置逻辑 → 组中间件后置逻辑 → 全局中间件后置逻辑 → 响应
请求进入 → 全局中间件 → 路由组中间件 → 路由中间件 → 最终处理函数 → 路由中间件后置逻辑 → 路由组中间件后置逻辑 → 全局中间件后置逻辑 → 响应
```
## 内置中间件