.NET Core中Session ID与Redis存储Key不匹配问题排查

核心原因 #

你混淆了ASP.NET Core Session的对外暴露ID和底层分布式缓存存储键的关系：Session.Id是给应用层使用的标识，但框架在将Session数据写入Redis时，不会直接用这个ID作为缓存键的一部分，而是会对其做哈希处理后再生成最终键。

详细解释 #

• 框架的存储逻辑：当你配置AddStackExchangeRedisCache作为Session的存储时，ASP.NET Core会对Session.Id执行以下操作生成Redis键：
  1. 构造内部键前缀：Microsoft.AspNetCore.Session.SessionId{Session.Id}
  2. 对这个字符串进行SHA256哈希计算
  3. 取哈希结果的部分字符（默认是Base64编码后做替换处理），再加上你配置的InstanceName作为前缀，形成最终的Redis键
• 设计目的：这种处理是为了避免Session ID直接暴露在缓存键中，同时保证键的长度可控（哈希后长度固定），避免因Session ID格式变化导致的键兼容性问题。

验证方法 #

你可以通过以下代码复现框架生成缓存键的逻辑，验证是否和Redis中实际存在的键一致：

using System.Security.Cryptography;
using System.Text;

// 替换为你的实际配置值
string instanceName = "local";
string sessionId = "b0208014-03da-9fc2-e444-791aa5e5ab3c";

// 步骤1：构造内部前缀
string sessionKeyPrefix = $"Microsoft.AspNetCore.Session.SessionId{sessionId}";

// 步骤2：SHA256哈希计算
byte[] hashBytes;
using (var sha256 = SHA256.Create())
{
    hashBytes = sha256.ComputeHash(Encoding.UTF8.GetBytes(sessionKeyPrefix));
}

// 步骤3：处理哈希结果（和框架内部逻辑一致）
string hashedKey = Convert.ToBase64String(hashBytes)
    .Replace('+', '-')
    .Replace('/', '_')
    .TrimEnd('=');

// 步骤4：拼接实例名得到最终Redis键
string finalRedisKey = $"{instanceName}{hashedKey}";

// 输出结果会和你在Redis中看到的键一致

总结 #

这是ASP.NET Core Session使用分布式缓存时的默认行为，不需要额外修改配置。如果你需要在业务中关联Session.Id和Redis存储键，可以用上述代码进行转换。

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