MAUI Shell应用登录登出时如何重新初始化单例页面与ViewModel？

问题背景 #

开发MAUI应用时采用Shell标签页架构，页面及对应ViewModel均注册为单例。初始加载时，页面通过OnAppearing调用ViewModel初始化方法，从LiteDb本地数据库拉取数据展示。但执行登出（清除SecureStorage会话、删除本地用户数据）并重新登录后，主标签页仍显示上一用户的数据，核心原因是单例实例未被销毁或重置。

最优解决方案 #

方案1：将页面/ViewModel改为作用域服务（推荐） #

把单例注册改为Scoped，确保每次登录后生成全新的页面和ViewModel实例。

1. 修改MauiProgram.cs中的服务注册：

// 替换原有单例注册
// builder.Services.AddSingleton<DashboardMainPage>();
// builder.Services.AddSingleton<DashboardMainViewModel>();

// 改为作用域注册
builder.Services.AddScoped<DashboardMainPage>();
builder.Services.AddScoped<DashboardMainViewModel>();
// 其他标签页的页面和ViewModel同理修改

2. 登出后导航至登录页，重新登录进入MainShellPage时，依赖注入容器会自动创建新的Scoped实例，页面OnAppearing触发的初始化逻辑会加载新用户数据。

方案2：手动重置ViewModel数据（无需修改注册方式） #

在ViewModel中添加重置方法，登出时清空数据，登录后重新初始化。

1. 在ViewModel中实现重置与初始化逻辑：

public class DashboardMainViewModel : BaseViewModel
{
    public ObservableCollection<DataItem> Items { get; set; } = new();
    private readonly IDataRepository _repository;

    public DashboardMainViewModel(IDataRepository repository)
    {
        _repository = repository;
    }

    public async Task InitDataAsync()
    {
        var data = await _repository.GetAllAsync();
        Items.Clear();
        foreach (var item in data) Items.Add(item);
    }

    public void ResetData()
    {
        Items.Clear();
        // 清空其他关联状态、缓存数据
    }
}

2. 登出流程中调用所有标签页ViewModel的重置方法：

try
{
    SecureStorage.Default.RemoveAll();
    await _repositories.ClearAsync();

    // 遍历所有标签页，重置ViewModel数据
    foreach (var tab in Shell.Current.Items.OfType<Tab>())
    {
        foreach (var shellContent in tab.Items)
        {
            if (shellContent.Content is Page page && page.BindingContext is DashboardMainViewModel vm)
            {
                vm.ResetData();
            }
        }
    }

    await Shell.Current.GoToAsync($"//{nameof(SignInUpPage)}");
}
catch (Exception)
{
    Toast.Show("Something went wrong");
}

3. 重新登录进入MainShellPage时，OnAppearing会再次触发InitDataAsync，加载新用户的本地数据。

方案3：强制Shell重新创建页面实例 #

通过动态修改ShellContent的ContentTemplate，触发页面实例重建。

1. 调整MainShellPage.xaml中的ShellContent配置：

<Tab Title="{Binding Dashboard.Title}" Icon="{Binding Dashboard.Icon}">
    <ShellContent x:Name="DashboardContent" Route="DashboardMainPage" />
</Tab>

2. 登录成功后重置ContentTemplate：

// 登录成功进入MainShellPage后执行
var dashboardTab = Shell.Current.Items.OfType<Tab>().First(t => t.Title == "Dashboard");
var dashboardContent = dashboardTab.Items.OfType<ShellContent>().First();
dashboardContent.ContentTemplate = new DataTemplate(typeof(DashboardMainPage));
// 其他标签页执行同样操作

方案4：清理导航栈并重新初始化 #

登出时清空导航栈，重新登录后通过LoadingPage重新进入MainShellPage，确保页面实例重建。

1. 修改登出流程的导航逻辑：

try
{
    SecureStorage.Default.RemoveAll();
    await _repositories.ClearAsync();

    // 清空导航栈，仅保留LoadingPage
    var currentStack = Shell.Current.Navigation.NavigationStack.ToList();
    foreach (var page in currentStack.Where(p => p.GetType() != typeof(LoadingPage)))
    {
        Shell.Current.Navigation.RemovePage(page);
    }

    await Shell.Current.GoToAsync($"//{nameof(SignInUpPage)}");
}
catch (Exception)
{
    Toast.Show("Something went wrong");
}

2. 重新登录后，LoadingPage会重新导航至MainShellPage，触发页面实例的重新创建（配合方案1使用效果更佳）。

内容的提问来源于stack exchange，提问作者Zoltán