MAUI MVVM模式下QueryProperty无法传递对象问题排查

1. 确认QueryProperty特性的正确使用 #

• 目标ViewModel必须用[QueryProperty]标记接收属性，注意属性名与查询参数名严格对应：
  示例：若导航传参键为SelectedIssue，特性需写为[QueryProperty(nameof(SelectedIssue), "SelectedIssue")]，第一个参数是ViewModel的属性名，第二个是查询字符串键名，大小写敏感。
• 接收属性必须是公开可读写的属性（包含get和set访问器），不能是只读或私有属性。

2. 复杂对象的序列化验证 #

Shell传递复杂对象依赖JSON序列化，需确保：

• ImEventIssue类具备可序列化条件：
  • 类标记[Serializable]特性（可选但推荐），且所有属性为公共类型，存在无参构造函数。
  • 避免包含循环引用、非序列化委托/事件等无法被JSON序列化的类型。
• 手动测试序列化：将ImEventIssue对象转为JSON字符串，再反序列化回对象，验证过程无异常。

3. 导航参数传递方式检查 #

MVVM架构下需通过Dictionary<string, object>传递参数，示例代码：

await Shell.Current.GoToAsync(nameof(EventIssueDetailPage), new Dictionary<string, object>
{
    { "SelectedIssue", selectedImEventIssue }
});

禁止用字符串拼接方式传递复杂对象，必须依赖Shell自动处理序列化逻辑。

4. 页面路由配置确认 #

确保目标页面已在Shell路由中注册：

• XAML方式（AppShell.xaml）：

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

• 代码方式：

  Routing.RegisterRoute(nameof(EventIssueDetailPage), typeof(EventIssueDetailPage));
  

路由名称需与导航时使用的页面名称完全一致。

5. ViewModel生命周期与赋值时机排查 #

• 在接收属性的setter中添加调试断点，确认是否被触发；若未触发，检查ViewModel是否在导航完成前已初始化，或绑定上下文设置时机是否错误。
• 不要在ViewModel构造函数中直接访问接收属性，导航参数通常在页面导航完成后才会赋值，构造函数执行时属性大概率为null。

6. 自定义导航逻辑排查 #

若项目中自定义了Shell导航生命周期事件（如Navigating、Navigated），或替换了默认JSON序列化器，需确认这些逻辑未干扰参数的传递与反序列化。

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