如何在.NET Maui与ASP.NET Core中通过Web Authenticator实现完全登出

问题核心 #

你遇到的自动登录问题，本质是两个层面的会话没彻底清除：

1. 后端调用HttpContext.SignOutAsync()只清理了ASP.NET Core自身的认证Cookie，但Google的会话Cookie存储在Maui WebAuthenticator调用的系统Web组件（Android自定义标签、iOS SafariViewController）中，后端无法直接操作这些第三方Cookie。
2. 现有登出逻辑未触发Google的官方登出流程，Google端仍保留用户登录状态，导致下次跳转授权页面时直接放行。

后端登出逻辑修复 #

修改Logout方法，同时处理自身认证状态和Google的登出流程：

using Microsoft.AspNetCore.Authentication.Cookies;

[HttpPost("logout")]
public async Task<IActionResult> Logout()
{
    try
    {
        // 清除ASP.NET Core的Cookie认证会话
        await HttpContext.SignOutAsync(CookieAuthenticationDefaults.AuthenticationScheme);
        // 清除Google认证相关的会话状态
        await HttpContext.SignOutAsync("Google");

        // 跳转到Google官方登出页面，完成后跳转回应用
        var redirectUri = Uri.EscapeDataString($"{callbackScheme}://logout-complete");
        var googleLogoutUrl = $"https://accounts.google.com/logout?continue={redirectUri}";
        return Redirect(googleLogoutUrl);
    }
    catch (Exception ex)
    {
        Debug.WriteLine($"登出失败: {ex.Message}");
        return BadRequest();
    }
}

注意：确保你在Program.cs/Startup中配置Google认证时，Scheme名称为"Google"（默认配置即为该名称）。

Maui移动端清理Web缓存 #

由于WebAuthenticator依赖系统级Web组件，需在移动端手动清理其缓存和Cookie：

Android平台 #

在MainActivity.cs中添加清理方法：

public void ClearWebAuthCache()
{
    var cookieManager = CookieManager.Instance;
    cookieManager.RemoveAllCookies(null);
    cookieManager.Flush();
}

iOS平台 #

在AppDelegate.cs中添加清理方法：

public void ClearWebAuthCache()
{
    NSHttpCookieStorage.SharedStorage.RemoveAllCookies();
    WKWebsiteDataStore.DefaultDataStore.FetchDataRecordsOfTypes(
        WKWebsiteDataStore.AllWebsiteDataTypes,
        records =>
        {
            foreach (var record in records)
            {
                WKWebsiteDataStore.DefaultDataStore.RemoveDataOfTypes(
                    record.DataTypes,
                    new[] { record },
                    () => {});
            }
        });
}

跨平台调用 #

通过依赖服务在共享代码中调用平台特定的清理逻辑：

1. 定义接口：

public interface IWebCacheCleaner
{
    void ClearCache();
}

2. Android实现：

[assembly: Dependency(typeof(AndroidWebCacheCleaner))]
namespace YourApp.Droid
{
    public class AndroidWebCacheCleaner : IWebCacheCleaner
    {
        public void ClearCache()
        {
            ((MainActivity)Platform.CurrentActivity).ClearWebAuthCache();
        }
    }
}

3. iOS实现：

[assembly: Dependency(typeof(IosWebCacheCleaner))]
namespace YourApp.iOS
{
    public class IosWebCacheCleaner : IWebCacheCleaner
    {
        public void ClearCache()
        {
            ((AppDelegate)UIApplication.SharedApplication.Delegate).ClearWebAuthCache();
        }
    }
}

4. 登出时调用：

var url = "http://localhost:5000/mobileauth/logout";
var response = await httpClient.PostAsync(url, null);
if (response.IsSuccessStatusCode)
{
    DependencyService.Get<IWebCacheCleaner>().ClearCache();
}

新手扫盲：Cookie、Tokens、Claims #

• Claims：用户的身份属性片段（如邮箱、用户ID），存储在ClaimsPrincipal中，后端登出时清除的是当前请求内存中的Claims，而非持久化的登录凭证。
• Cookie：后端用于维持用户会话的小型存储文件，SignOutAsync()仅清理自身服务的Cookie，第三方（如Google）的Cookie需单独清理。
• Access/Refresh Tokens：若你的流程获取了Google的Token，登出时需删除本地保存的Token，也可调用Google的Token撤销接口让Token失效（可选）。

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