Handler 与 RequestContext

如何在 Handler 中读取 HTTP 输入？

func getArticle(ctx context.Context, c *app.RequestContext) {
	id := c.Param("id")
	keyword := c.Query("keyword")
	contentType := c.Request.Header.Get("Content-Type")

	c.JSON(consts.StatusOK, map[string]string{
		"id": id, "keyword": keyword, "content_type": contentType,
	})
}

• ctx: 传递取消、deadline 和请求范围值给 Service 与外部依赖;
• c: 读取 HTTP 请求并构造 HTTP 响应;
• Param: 获取路由参数;
• Query: 获取查询参数; 缺失和空字符串需要按契约区分;
• Request.Header: 读取 Header; Header 名大小写不应承载业务差异;

如何读取中间件传入的身份？

c.Set("user_id", int64(42))
value, exists := c.Get("user_id")

• 使用场景: 认证中间件把已经验证的身份传给 Handler;
• 类型边界: 读取后必须检查 exists 和类型断言;
• 敏感数据: 不把密码、完整 Token 或大对象放入上下文;

如何避免 RequestContext 越过有效期？

• RequestContext: 请求结束即被复用，后台任务不能持有原引用；必要时用 Copy() 或 Exile()，一般只复制业务所需数据;
• 实践: 异步任务需要复制所需值和字节; 不直接捕获 c;
• Service: 不依赖 *app.RequestContext; 只接收标准 context 和领域参数;
• Handler: 不负责事务、缓存策略和复杂业务分支;