.NET 4.6.2 MVC基控制器异步获取AccessToken遇超时及异步错误求助

AI 小北

2026-7-11

解决方案与重构建议

问题根源分析

你遇到的两个核心问题：

异步操作未正确等待：基控制器中使用void同步方法调用异步任务，ASP.NET无法追踪异步操作状态，导致模块提前完成，抛出an asynchronous module or handler completed while an asynchronous operation was still pending错误。
同步阻塞导致死锁/超时：用GetResult()强制阻塞线程等待异步任务，会占用ASP.NET的同步上下文，引发线程死锁，直接导致请求加载缓慢甚至超时。

正确实现方案：异步化基控制器逻辑

.NET MVC 5及以上版本支持异步动作过滤器，我们可以将基控制器的生命周期方法改为异步版本，用await正确等待AccessToken获取，避免阻塞。

1. 重构基控制器为异步模式

public class BaseController : Controller
{
    private readonly IAccessTokenProvider _accessTokenProvider;

    // 通过依赖注入注入Token服务（替代每次new，提升复用性）
    public BaseController(IAccessTokenProvider accessTokenProvider)
    {
        _accessTokenProvider = accessTokenProvider;
    }

    // 重写异步版的动作执行前方法，替代原void版OnActionExecuting
    protected override async Task OnActionExecutingAsync(ActionExecutingContext filterContext, CancellationToken cancellationToken)
    {
        await base.OnActionExecutingAsync(filterContext, cancellationToken);

        // 异步获取AccessToken，用await而非阻塞调用
        var accessToken = await _accessTokenProvider.AcquireAccessTokenAsync(filterContext);

        if (string.IsNullOrEmpty(accessToken))
        {
            // Token获取失败时的兜底处理，比如跳转到登录页
            filterContext.Result = new RedirectResult("/Account/Login");
            return;
        }

        // 将有效Token存入ViewBag供后续API调用使用
        ViewBag.AccessToken = accessToken;
    }
}

2. 优化AccessToken获取与缓存

每次请求都调用API获取Token是性能瓶颈，加入缓存逻辑减少重复请求：

public interface IAccessTokenProvider
{
    Task<string> AcquireAccessTokenAsync(ActionExecutingContext filterContext);
}

public class AccessTokenProvider : IAccessTokenProvider
{
    private const string GlobalTokenCacheKey = "GlobalValidAccessToken";
    private const string TokenExpiryCacheKey = "GlobalTokenExpiry";

    public async Task<string> AcquireAccessTokenAsync(ActionExecutingContext filterContext)
    {
        var cache = MemoryCache.Default;
        // 检查缓存中是否有有效Token
        var cachedToken = cache.Get(GlobalTokenCacheKey) as string;
        var tokenExpiry = cache.Get(TokenExpiryCacheKey) as DateTime?;

        if (!string.IsNullOrEmpty(cachedToken) 
            && tokenExpiry.HasValue 
            && tokenExpiry.Value > DateTime.UtcNow)
        {
            return cachedToken;
        }

        // 缓存失效时，调用Auth API获取新Token
        using var httpClient = new HttpClient();
        var tokenRequestContent = new FormUrlEncodedContent(new Dictionary<string, string>
        {
            {"grant_type", "client_credentials"},
            {"client_id", "你的客户端ID"},
            {"client_secret", "你的客户端密钥"}
        });

        var response = await httpClient.PostAsync("https://你的认证API地址/token", tokenRequestContent);
        response.EnsureSuccessStatusCode();
        
        var tokenResponse = await response.Content.ReadAsAsync<TokenResponse>();
        // 缓存Token（设置比实际过期时间早5分钟，避免刚好过期的边缘情况）
        var expiryTime = DateTime.UtcNow.AddSeconds(tokenResponse.ExpiresIn - 300);
        cache.Set(GlobalTokenCacheKey, tokenResponse.AccessToken, new CacheItemPolicy { AbsoluteExpiration = expiryTime });
        cache.Set(TokenExpiryCacheKey, expiryTime, new CacheItemPolicy { AbsoluteExpiration = expiryTime });

        return tokenResponse.AccessToken;
    }
}

// 对应Auth API返回的Token模型
public class TokenResponse
{
    [JsonProperty("access_token")]
    public string AccessToken { get; set; }

    [JsonProperty("expires_in")]
    public int ExpiresIn { get; set; }
}

3. 注册依赖注入

在Global.asax的Application_Start中注册Token服务，让控制器能通过构造函数获取实例：

protected void Application_Start()
{
    // 其他MVC初始化代码...

    // 注册依赖解析器（这里用MVC自带实现，也可替换为Autofac/Unity等容器）
    DependencyResolver.SetResolver(new DefaultDependencyResolver
    {
        GetService = type =>
        {
            if (type == typeof(IAccessTokenProvider))
                return new AccessTokenProvider();
            return null;
        },
        GetServices = type => Enumerable.Empty<object>()
    });
}

额外注意事项

如果是用户专属Token（而非全局客户端Token），缓存Key需要加上用户ID，避免不同用户共用Token。
若存在多线程并发请求Token的场景，可在缓存检查逻辑中加入双重锁定，防止重复调用Auth API。
禁止在控制器构造函数中执行异步操作，构造函数无法标记为async，所有异步逻辑需放在OnActionExecutingAsync等生命周期方法中。

内容的提问来源于stack exchange，提问作者dotnetpleb