如何让MSAL持久化令牌实现Office365非交互式OAuth2认证？

你遇到的核心问题是MSAL默认使用内存令牌缓存，程序重启后缓存就被清空了，所以每次重启GetAccountsAsync()都拿不到之前的账户信息。要实现非交互式登录，关键是把令牌缓存（包含账户信息和刷新令牌）持久化到本地存储，下次启动时再加载回来。

1. 先确保添加offline_access权限 #

首先要把offline_access加入你的请求范围——这个权限是获取刷新令牌的前提，没有它，即使缓存了令牌，过期后也没法静默刷新，还是得重新登录。修改你的scopes：

var scopes = new string[] { "https://outlook.office.com/IMAP.AccessAsUser.All", "offline_access" };

2. 实现令牌缓存的持久化逻辑 #

MSAL允许通过回调函数自定义缓存的读写行为，我们可以把缓存序列化为JSON文件存在本地（比如用户的AppData目录，避免权限问题）。先写一个辅助类处理缓存：

public class TokenCacheHelper
{
    // 缓存文件存在用户本地应用数据目录
    private static readonly string CacheFilePath = Path.Combine(
        Environment.GetFolderPath(Environment.SpecialFolder.LocalApplicationData),
        "MsalImapTokenCache.json");

    // 从文件加载缓存到内存
    public static void LoadCache(ITokenCache tokenCache)
    {
        if (File.Exists(CacheFilePath))
        {
            tokenCache.DeserializeMsalV3(File.ReadAllBytes(CacheFilePath));
        }
    }

    // 把内存中的缓存保存到文件
    public static void SaveCache(ITokenCache tokenCache)
    {
        File.WriteAllBytes(CacheFilePath, tokenCache.SerializeMsalV3());
    }

    // 给PublicClientApplication绑定缓存读写回调
    public static void BindCache(PublicClientApplication pca)
    {
        pca.UserTokenCache.SetBeforeAccessAsync(async args =>
        {
            await Task.Run(() => LoadCache(args.TokenCache));
        });

        pca.UserTokenCache.SetAfterAccessAsync(async args =>
        {
            // 只有缓存状态变化时才保存（比如拿到新令牌、刷新令牌）
            if (args.HasStateChanged)
            {
                await Task.Run(() => SaveCache(args.TokenCache));
            }
        });
    }
}

3. 修改你的Test方法，绑定缓存逻辑 #

在构建PublicClientApplication之后，绑定我们的缓存处理逻辑，这样每次缓存变化时都会自动读写文件：

internal async Task<string> Test()
{
    var pca = PublicClientApplicationBuilder.Create("5896de31-e251-460c-9dc2-xxxxxxxxxxxx")
        .WithRedirectUri("https://login.microsoftonline.com/common/oauth2/nativeclient")
        .WithAuthority(AzureCloudInstance.AzurePublic, ConfigurationManager.AppSettings["tenantId"])
        .Build();

    // 绑定令牌缓存持久化逻辑
    TokenCacheHelper.BindCache(pca);

    var scopes = new string[] { "https://outlook.office.com/IMAP.AccessAsUser.All", "offline_access" };

    var accounts = await pca.GetAccountsAsync();
    var firstAccount = accounts.FirstOrDefault();
    AuthenticationResult authResult = null;

    try
    {
        if (firstAccount != null)
        {
            // 尝试静默获取令牌（如果旧令牌过期，会自动用刷新令牌刷新）
            authResult = await pca.AcquireTokenSilent(scopes, firstAccount)
                .ExecuteAsync();
        }
    }
    catch (MsalUiRequiredException)
    {
        // 静默失败的情况：第一次登录、令牌过期且无刷新令牌、权限变更等
        authResult = await pca.AcquireTokenInteractive(scopes)
            .ExecuteAsync();
    }

    // 后续IMAP逻辑保持不变
    MailBee.Global.LicenseKey = "MN120-569E9E8D9E5B9E8D9EC8C4BC83D3-D428";
    MailBee.ImapMail.Imap imap = new MailBee.ImapMail.Imap();
    var xOAuthkey = MailBee.OAuth2.GetXOAuthKeyStatic(authResult.Account.Username, authResult.AccessToken);
    imap.Connect("imap.outlook.com", 993);
    imap.Login(null, xOAuthkey, AuthenticationMethods.SaslOAuth2, AuthenticationOptions.None, null);
    imap.SelectFolder("INBOX");
    var count = imap.MessageCount.ToString();

    return authResult.AccessToken;
}

4. 关键说明 #

• 第一次运行时仍需要交互式登录，登录成功后，MSAL会把账户信息和刷新令牌自动保存到本地文件
• 后续重启程序时，GetAccountsAsync()会从缓存文件加载之前的账户，然后通过AcquireTokenSilent静默获取新的访问令牌（过期自动刷新）
• 缓存文件存在用户专属的LocalAppData目录，既安全又不会和其他用户的缓存冲突

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