跨方法读写Session数据异常：始终返回0的问题求助

你的问题核心在于ASP.NET Core Session的默认行为限制，导致DownloadProgress方法无法读取到DownloadExcel中实时更新的进度值，具体原因和解决办法如下：

为什么读不到Session更新值？ #

1. Session延迟提交：ASP.NET Core默认会在请求完全结束（返回响应）后才将Session的变更提交到存储介质中。也就是说，DownloadExcel方法在循环更新Session时，这些变更并不会立即持久化，直到整个方法执行完毕、返回File结果后才会提交，所以中间的DownloadProgress请求读到的始终是初始的0。

2. Session独占锁机制：Session默认是单请求独占的，当DownloadExcel请求长时间运行并持有Session锁时，后续的DownloadProgress请求会被阻塞，直到DownloadExcel完成后才能获取Session，这时候读到的要么是最终值，要么还是初始值（如果提交时机晚）。

解决方案 #

方案一：手动提交Session变更 #

通过注入ISessionStore，在每次更新Session后手动提交，让Progress请求能实时读到最新值：

private readonly ISessionStore _sessionStore;

// 构造函数注入ISessionStore
public YourController(ISessionStore sessionStore)
{
    _sessionStore = sessionStore;
}

[HttpPost]
public async Task<IActionResult> DownloadExcel([FromBody] filter)
{
    HttpContext.Session.SetInt32("ProductExcelCount", 0);
    // 初始值提交
    await _sessionStore.CommitAsync(HttpContext.Session, CancellationToken.None);

    // 循环处理行数据
    foreach(var row in rows)
    {
        // 业务处理逻辑
        rowNo++;
        HttpContext.Session.SetInt32("ProductExcelCount", rowNo);
        // 每次更新后立即提交Session
        await _sessionStore.CommitAsync(HttpContext.Session, CancellationToken.None);
    }

    var FileName = $"Template.xlsx";
    return File(content, contentType, FileName);
}

方案二：改用分布式缓存存储进度（更推荐） #

Session设计初衷是存储用户会话的短期轻量数据，不适合长时间运行任务的进度追踪。改用分布式缓存（如Redis、MemoryCache）可以避免Session锁和提交延迟问题，同时支持多用户隔离：

1. 注入IDistributedCache：

private readonly IDistributedCache _distributedCache;

public YourController(IDistributedCache distributedCache)
{
    _distributedCache = distributedCache;
}

2. DownloadExcel中更新进度：

[HttpPost]
public async Task<IActionResult> DownloadExcel([FromBody] filter)
{
    // 用用户唯一标识作为缓存键，避免多用户进度冲突
    var progressKey = $"ExcelProgress_{User.Identity.Name}";
    await _distributedCache.SetStringAsync(progressKey, "0");

    foreach(var row in rows)
    {
        rowNo++;
        // 更新进度到缓存，同时设置过期时间避免缓存堆积
        await _distributedCache.SetStringAsync(progressKey, rowNo.ToString(), new DistributedCacheEntryOptions
        {
            AbsoluteExpirationRelativeToNow = TimeSpan.FromMinutes(30)
        });
    }

    // 任务完成后清理缓存
    await _distributedCache.RemoveAsync(progressKey);

    var FileName = $"Template.xlsx";
    return File(content, contentType, FileName);
}

3. DownloadProgress读取进度：

public async Task<JsonResult> DownloadProgress()
{
    var progressKey = $"ExcelProgress_{User.Identity.Name}";
    var excelCountStr = await _distributedCache.GetStringAsync(progressKey);
    var ExcelCount = int.TryParse(excelCountStr, out var count) ? count : 0;
    return Json(new { downloadData = new { ExcelCount } });
}

额外优化建议 #

• 前端setInterval的20秒间隔太长，建议改为3-5秒，让进度反馈更及时。
• 如果是匿名用户场景，可以用随机生成的请求ID作为缓存键，避免进度混淆。

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