升级Microsoft.IdentityModel.Clients.ActiveDirectory后旧令牌反序列化失败求迁移方案

这个问题我之前帮团队处理过，ADAL 3.10到高版本的序列化不兼容确实是个坑——毕竟3.10版本已经从NuGet下架了，但还是有可行的迁移方案，下面分步骤说明：

方案1：临时保留ADAL 3.10 DLL做过渡迁移 #

这是最可靠的方法，核心思路是用旧版本DLL先解析旧令牌，再用新版本生成兼容的新令牌：

• 找回ADAL 3.10 DLL：虽然NuGet官方移除了，但你可以从本地开发环境的NuGet缓存目录（一般是%userprofile%\.nuget\packages）查找是否有历史缓存的包；或者从项目的旧版本代码提交、备份文件中提取该DLL。
• 搭建临时解析服务/工具：创建一个单独的控制台项目或临时服务，仅引用ADAL 3.10版本，编写代码读取数据库中存储的旧令牌字符串，反序列化为AuthenticationResult对象（注意必须用3.10版本的命名空间Microsoft.IdentityModel.Clients.ActiveDirectory下的类型）。
• 生成新版本兼容令牌：拿到旧AuthenticationResult中的RefreshToken，在新版本ADAL（或MSAL，如果是迁移到微软推荐的MSAL）中调用AcquireTokenByRefreshTokenAsync（ADAL）或对应的MSAL方法，获取新版本的AuthenticationResult，然后将其序列化后覆盖存储到数据库中。

方案2：手动解析旧令牌的序列化结构（无旧DLL时备选） #

如果实在找不到ADAL 3.10的DLL，可以尝试手动解析旧令牌的序列化内容：

• 判断序列化格式：ADAL 3.10默认可能用DataContractSerializer做二进制序列化，也可能是JSON（取决于你的存储代码）。如果是JSON格式，可以直接用Newtonsoft.Json等工具解析；如果是二进制，这个方法不太适用，建议优先找旧DLL。
• 创建匹配旧结构的DTO：ADAL 3.10的AuthenticationResult序列化后核心字段包括：AccessToken、RefreshToken、ExpiresOn、TenantId、UserId、IdToken等。创建一个包含这些字段的DTO类，用JSON反序列化将数据库中的字符串转为DTO对象。
• 用刷新令牌生成新令牌：拿到DTO中的RefreshToken，调用新版本ADAL/MSAL的刷新令牌接口，生成兼容新版本的令牌并存储。

关键注意事项 #

• 备份数据优先：迁移前务必全量备份数据库中的旧令牌数据，避免操作失误导致数据丢失。
• 分批验证：先选取小部分用户的令牌做迁移测试，验证新版本能正常使用新令牌后，再批量处理所有数据。
• 迁移到MSAL的额外提示：如果最终是要迁移到MSAL（微软已弃用ADAL，推荐升级到MSAL），注意MSAL不支持直接解析ADAL的令牌，必须通过上述方法先获取刷新令牌，再用MSAL的AcquireTokenByRefreshToken（部分版本支持）或AcquireTokenSilent结合刷新令牌的方式生成MSAL格式的令牌。

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