.NET MAUI MVVM视图InitializeAsync未自动执行问题求助

你自定义的IViewModelBase和ViewModelBase并没有和.NET MAUI的导航系统建立关联，MAUI原生导航不会自动识别并调用你重写的InitializeAsync方法——官方示例里的自动触发是因为示例中已经完成了ViewModel生命周期与导航事件的绑定逻辑，而你没有把这套绑定逻辑同步到自己的项目中。

以下是三种无需在页面代码后置手动调用的解决方案：

方案1：利用MVVM Community Toolkit的IAsyncInitializable接口 #

如果你的项目使用较新版本的MVVM Community Toolkit，可以直接用框架内置的生命周期接口：

• 让ProjectPageViewModel继承Toolkit的ObservableObject，并实现IAsyncInitializable接口（替代你自定义的IViewModelBase）
• 使用Toolkit的导航服务注册路由，而非MAUI原生路由

示例代码：

// ViewModel代码
using CommunityToolkit.Mvvm.ComponentModel;
using CommunityToolkit.Mvvm.Navigation;

public class ProjectPageViewModel : ObservableObject, IAsyncInitializable
{
    public async Task InitializeAsync(CancellationToken cancellationToken)
    {
        // 你的初始化逻辑
    }
}

// App.xaml.cs中注册路由
using CommunityToolkit.Maui.Views;

public partial class App : Application
{
    public App()
    {
        InitializeComponent();
        // 使用Toolkit的RegisterRoute
        RegisterRoute(nameof(ProjectPage), typeof(ProjectPage));
    }
}

当通过Toolkit的导航服务跳转到ProjectPage时，InitializeAsync会自动执行。

方案2：自定义导航服务封装初始化逻辑 #

自己实现一个导航服务，在导航过程中自动调用ViewModel的InitializeAsync：

public class CustomNavigationService
{
    private readonly INavigation _navigation;

    public CustomNavigationService(INavigation navigation)
    {
        _navigation = navigation;
    }

    // 约定ViewModel与页面命名规则：如ProjectPageViewModel对应ProjectPage
    public async Task NavigateToViewModelAsync<TViewModel>(object parameter = null) 
        where TViewModel : IViewModelBase, new()
    {
        var viewModel = new TViewModel();
        var pageTypeName = typeof(TViewModel).Name.Replace("ViewModel", "");
        var pageType = typeof(TViewModel).Assembly.GetType($"{typeof(TViewModel).Namespace}.{pageTypeName}");
        
        if (pageType == null)
            throw new InvalidOperationException($"未找到对应页面：{pageTypeName}");

        var page = (Page)Activator.CreateInstance(pageType);
        page.BindingContext = viewModel;

        // 先执行初始化再导航
        await viewModel.InitializeAsync(parameter);
        await _navigation.PushAsync(page);
    }
}

使用时注入该服务，调用await _navigationService.NavigateToViewModelAsync<ProjectPageViewModel>()即可自动触发初始化。

方案3：通过附加属性绑定页面导航事件 #

写一个MAUI附加属性，监听页面的NavigatedTo事件，自动调用ViewModel的InitializeAsync：

public static class ViewModelInitializer
{
    public static readonly BindableProperty AutoInitializeProperty =
        BindableProperty.CreateAttached(
            "AutoInitialize", 
            typeof(bool), 
            typeof(ViewModelInitializer), 
            false,
            propertyChanged: OnAutoInitializeChanged);

    public static bool GetAutoInitialize(BindableObject bindable)
        => (bool)bindable.GetValue(AutoInitializeProperty);

    public static void SetAutoInitialize(BindableObject bindable, bool value)
        => bindable.SetValue(AutoInitializeProperty, value);

    private static async void OnAutoInitializeChanged(BindableObject bindable, object oldValue, object newValue)
    {
        if (bindable is Page page && (bool)newValue)
        {
            page.NavigatedTo += async (s, e) =>
            {
                if (page.BindingContext is IViewModelBase viewModel)
                {
                    await viewModel.InitializeAsync();
                }
            };
        }
    }
}

在页面XAML中启用该属性：

<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             xmlns:local="clr-namespace:YourAppNamespace"
             local:ViewModelInitializer.AutoInitialize="True">
    <!-- 页面内容 -->
</ContentPage>

这样每次页面被导航到，就会自动调用ViewModel的InitializeAsync。

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