.NET MAUI登录按钮事件触发后导航至首页时崩溃求助

排查与修复步骤 #

• 检查HomePage初始化逻辑
  崩溃大概率出在HomePage的初始化环节，而非导航方法本身。重点排查HomePage的构造函数、OnAppearing方法、绑定的ViewModel初始化代码：看是否存在空引用、未处理的API调用异常（比如登录后传递的用户信息为空但被直接使用）、资源加载失败（如未正确引用的图片/字体）。
• 强制捕获导航异常
  把导航代码包裹在try-catch块中，捕获所有异常信息（包括内部未公开的异常）：

  try
  {
      await Shell.Current.GoToAsync($"{nameof(HomePage)}");
  }
  catch (Exception ex)
  {
      System.Diagnostics.Debug.WriteLine($"导航异常详情: {ex.Message}\n{ex.StackTrace}");
      await DisplayAlert("错误提示", ex.Message, "确认");
  }
  

• 验证路由注册准确性
  确认AppShell中HomePage的路由注册完全匹配，检查是否有拼写错误：

  // AppShell路由注册代码示例
  Routing.RegisterRoute(nameof(HomePage), typeof(HomePage));
  

  同时确保HomePage未被错误注册为模态页面或嵌套在其他Shell结构中。
• 避免UI线程阻塞
  检查登录按钮事件处理器中，导航前的代码是否有同步阻塞UI线程的操作（如长时间同步IO），导致导航时UI线程状态异常。确保所有耗时操作（包括API调用）都用await异步执行。
• 简化HomePage布局排查
  临时简化HomePage的XAML，只保留基础元素（比如一个Label），测试是否还会崩溃。如果恢复正常，再逐步添加原布局元素，定位问题所在。
• 检查导航参数（若有）
  如果登录后向HomePage传递了参数，确认参数类型、值是否合法，比如是否传递了未序列化的对象，或参数为空但被强制转换导致异常。可先移除参数传递，测试纯导航是否正常。

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