开启EnableRequestCaching后如何在Account/Login方法获取自定义查询参数?
开启EnableRequestCaching后获取自定义查询参数的落地方案
核心原理说明
OpenIddict开启EnableRequestCaching后,授权端点的原始请求上下文会被序列化存入分布式缓存,后续重定向到Account/Login的请求仅会携带用于匹配缓存记录的流程标识,原始请求上附带的自定义参数不会直接出现在登录页请求的查询串中,直接从HttpContext.Request.Query取值会得到空值。
而OpenIddict内置的GetOpenIddictServerRequest()扩展方法本身就对请求缓存机制做了全兼容:关闭缓存时直接从当前HTTP请求解析参数,开启缓存时自动匹配当前流程对应的缓存记录、读取并反序列化完整请求上下文,全程不需要手动操作缓存读写逻辑。
具体实现步骤
- 引入对应命名空间
在控制器文件头部引入OpenIddict.Server.AspNetCore,即可调用上述请求解析扩展方法,不需要额外注入缓存服务或手动处理缓存键匹配逻辑。 - 在登录动作中解析自定义参数
调用扩展方法拿到完整的OpenIddict请求对象后,可直接读取通过customQueryParams传递的自定义culture参数,同步设置当前请求的Culture即可。 - 示例代码:
[HttpGet] [AllowAnonymous] [Route("/Account/Login")] public async Task<IActionResult> Login(string returnUrl = null) { // 自动解析缓存关联的OpenIddict请求,兼容EnableRequestCaching开启状态 var openIdRequest = await HttpContext.GetOpenIddictServerRequest(); // 读取客户端传递的自定义culture参数 var cultureValue = openIdRequest?.GetParameter("culture")?.Value?.GetString(); // 同步设置IDServer端的当前Culture if (!string.IsNullOrWhiteSpace(cultureValue)) { var targetCulture = new CultureInfo(cultureValue); CultureInfo.CurrentCulture = targetCulture; CultureInfo.CurrentUICulture = targetCulture; } // 保留原有登录页初始化逻辑 ViewData["ReturnUrl"] = returnUrl; return View(); }
关键注意事项
- 通过angular-oauth2-oidc的
customQueryParams传递的自定义参数,只要是挂载到授权端点原始请求上的字段,都会被OpenIddict完整写入缓存的请求对象中,不会因为开启请求缓存丢失,不需要在跳转登录页的重定向URL中手动透传这些参数。 - 自定义参数名需要避开OpenIddict定义的保留标准参数(如
client_id、response_type、scope等),使用culture这类业务自定义命名可正常被解析。 - 如果
Account/Login动作包含POST提交逻辑,上述解析逻辑不受请求方法影响,同样可以正常获取缓存的请求参数。 - 若需要在登录后的全流程持续保持culture设置,建议在登录成功后将culture值写入用户认证Cookie或用户Claims,避免后续请求重复解析缓存。
内容的提问来源于stack exchange,提问作者MFARKAN
相关产品推荐
相关产品推荐

