Revel 中的 c 是框架自动注入的 *revel.Controller 类型请求上下文,无需手动获取;c.Params.Get("key") 统一提取各来源参数,c.Request 提供原始 HTTP 访问能力,且 c 与 Go 标准库 context.Context 无关。

Revel 中的 c 就是请求上下文,不是要“获取”,而是它天然存在
Revel 的控制器方法签名里那个 c 参数(如 func (c App) Index()),本身就是框架注入的完整请求上下文对象,类型为 *revel.Controller。它不是靠 revel.Context 或 context.Context(Go 标准库)手动传入或构造的——你不需要调用任何函数去“获取”它,它就在那儿。
容易混淆的点在于名字:Revel 早期版本曾暴露过 revel.Context 类型,但自 v0.20+ 起已彻底移除;现在所有上下文能力都封装在 *revel.Controller 实例中。如果你在文档或旧代码里看到 revel.Context,基本可以判定是过时写法。
c.Params.Get() 是提取查询/表单参数的统一入口,不是按来源区分
Revel 把 URL 查询字符串、路径参数、POST 表单、multipart 数据全部归一化到 c.Params,不区分 Query / Form / Path —— 它内部自动合并、去重、优先级排序(Query > Form > Path)。所以:
-
c.Params.Get("id")可同时匹配/user/123(路径参数)、/user?id=123(查询参数)、POST /user id=123(表单) - 若需明确只取查询参数,可用
c.Params.Values["id"]拿到[]string切片,再手动过滤c.Request.URL.Query()的结果 - 路径参数必须在 routes 文件中显式声明(如
GET /user/{id}),否则c.Params.Get("id")对路径段无效
c.Request 提供原始 HTTP 请求对象,用于读取 Header / Body / IP
当你需要绕过 Revel 封装,直接访问底层 HTTP 语义时,就用 c.Request(类型为 *http.Request):
- 客户端真实 IP:
c.Request.Header.Get("X-Forwarded-For")或c.Request.RemoteAddr(注意代理场景) - 请求头字段:
c.Request.Header.Get("Authorization")、c.Request.Header.Get("User-Agent") - 原始请求体:
io.ReadAll(c.Request.Body)(⚠️只能读一次,读完后c.Request.Body为空) - 注意:
c.Request.ParseForm()必须在首次访问c.Request.PostForm前显式调用,否则表单数据为空
不要试图从 c 中提取 Go 标准库的 context.Context
Revel 的 *revel.Controller 和 Go 的 context.Context 是两套东西:前者是 Web 请求生命周期封装,后者是 goroutine 传播取消信号和值的机制。Revel 并未将标准 context.Context 注入 c 中。
如果你真需要在数据库调用或异步任务中传递超时或取消信号,得自己创建:
- 基于请求超时:
ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second) - 绑定到请求生命周期(较重):
ctx := context.WithValue(context.Background(), "request_id", c.Request.Header.Get("X-Request-ID")) - 但别指望
c自带一个可直接用的context.Context字段——它没有
最常被忽略的是:Revel 的 c 生命周期仅限于单个 HTTP 请求处理过程,它不携带跨请求状态,也不参与 Go 的 context 取消树。混用这两者是调试时最难定位的隐性 bug 来源之一。











