MAUI使用Community Toolkit传递导航参数时值为空的问题排查

针对你遇到的导航参数传递后ViewModel的PhotoDetails始终为空的问题，可按以下步骤逐一排查：

1. 确认Shell路由注册是否正确 #

检查AppShell.xaml中是否已正确注册PhotoDataPage的路由，未注册的话Shell无法完成正确导航并传递参数：

<ShellContent Route="PhotoDataPage" ContentTemplate="{DataTemplate local:PhotoDataPage}" />

2. 移除XAML中错误的BindingContext设置 #

你在XAML的VerticalStackLayout中设置了BindingContext="{x:Type viewmodel:PhotoDataViewModel}"，这会将绑定上下文指向类型而非实例，和后台构造函数中注入的ViewModel实例冲突，导致参数无法正确绑定到目标ViewModel。直接删除这行错误代码即可：

<!-- 移除此行无效设置 -->
<!-- <VerticalStackLayout BindingContext="{x:Type viewmodel:PhotoDataViewModel}"/> -->

3. 验证QueryProperty的属性匹配 #

再次确认QueryProperty的配置是否完全匹配：

• 由[ObservableProperty]生成的公共属性为PhotoDetails（首字母大写），需和QueryProperty第一个参数完全一致
• 传递参数的字典键nameof(PhotoDetailsFacade)需和QueryProperty的第二个参数完全一致，MAUI QueryProperty默认大小写敏感，需严格匹配

4. 理解QueryProperty的赋值时机 #

QueryProperty的属性赋值是在页面构造函数执行完成后、OnNavigatedTo方法执行期间完成的，因此在页面构造函数中查看ViewModel的PhotoDetails为空是正常现象。如需在参数赋值后执行逻辑，可在ViewModel中添加自动生成的属性变更回调：

[ObservableProperty]
private PhotoDetailsFacade photoDetails;

// 参数赋值后自动触发的回调方法
partial void OnPhotoDetailsChanged(PhotoDetailsFacade value)
{
    // 在这里处理参数接收后的逻辑，比如加载关联数据等
}

5. 排查复杂对象传递问题 #

如果PhotoDetailsFacade是自定义复杂类型，可先尝试传递简单类型（如字符串FilePath）验证导航流程是否正常：

• 传递端修改为：

  navigationParameter.Add("FilePath", PhotoDetails.FilePath);
  

• 接收端ViewModel添加：

  [QueryProperty("FilePath", "FilePath")]
  [ObservableProperty]
  private string filePath;
  

若简单类型能正常接收，说明复杂对象传递可能存在问题（如对象被提前回收），可考虑将复杂对象序列化为JSON字符串传递，或使用Singleton服务暂存对象。

6. 手动检查导航参数是否到达页面 #

在PhotoDataPage.xaml.cs中重写OnNavigatedTo方法，直接确认参数是否传递到页面：

protected override void OnNavigatedTo(NavigatedToEventArgs args)
{
    base.OnNavigatedTo(args);
    if (args.Parameter is Dictionary<string, object> parameters)
    {
        if (parameters.TryGetValue(nameof(PhotoDetailsFacade), out var value))
        {
            // 能拿到值说明参数已到页面，问题出在ViewModel的QueryProperty绑定，可手动赋值测试
            var vm = BindingContext as PhotoDataViewModel;
            vm.PhotoDetails = value as PhotoDetailsFacade;
        }
        else
        {
            // 参数未传递到页面，问题出在导航调用或路由注册环节
        }
    }
}

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