多页面导航触发Java.Lang.IllegalStateException等运行时错误求助

核心问题与现象 #

实际有4个页面，测试时使用Page1、Page2、Page3，按任意顺序切换页面时抛出错误：

Java.Lang.IllegalStateException: The specified child already has a parent. You must call removeView() on the child's parent first.
at System.Runtime.ExceptionServices.ExceptionDispatchInfo.Throw()

将布局从Grid改为FlexLayout后，出现新的编译崩溃错误：

Java.Lang.IllegalStateException: View with id -1: crc640ec207abc449b2ca.ShellPageContainer#onMeasure() did not set the measured dimension by calling setMeasuredDimension()

--- End of managed Java.Lang.IllegalStateException stack trace ---
java.lang.IllegalStateException: View with id -1: crc640ec207abc449b2ca.ShellPageContainer#onMeasure() did not set the measured dimension by calling setMeasuredDimension()

补充现象：

• 将Page1/Page2/Page3设为null时运行正常
• 页面无子元素时运行正常，但无法切换至其他页面，推测问题与子元素（如按钮）有关

相关代码片段 #

页面定义代码：

var Page1 = new VerticalStackLayout()
{
    HorizontalOptions = LayoutOptions.Center
};
var Page2 = new FlexLayout()
{
    AlignItems = FlexAlignItems.Center,
    Direction = FlexDirection.Column,
    WidthRequest = screen.Width / screen.Density
};
var Page3 = new FlexLayout()
{
    AlignItems = FlexAlignItems.Center,
    Direction = FlexDirection.Column,
    WidthRequest = screen.Width / screen.Density
};

页面切换逻辑：

btn1.Pressed += delegate
{
    Content = Page1;
};
btn2.Pressed += delegate
{
    Content = Page2;
};
btn3.Pressed += delegate
{
    Content = Page3;
};

解决方案 #

1. 解决“子元素已有父容器”错误 #

MAUI中单个View实例只能归属一个父容器，重复设置Content = PageX时，原父容器仍持有页面引用，导致冲突。切换前需先将页面从原父容器移除：

btn1.Pressed += delegate
{
    if (Page1.Parent != null)
    {
        ((Layout)Page1.Parent).Remove(Page1);
    }
    Content = Page1;
};

btn2.Pressed += delegate
{
    if (Page2.Parent != null)
    {
        ((Layout)Page2.Parent).Remove(Page2);
    }
    Content = Page2;
};

btn3.Pressed += delegate
{
    if (Page3.Parent != null)
    {
        ((Layout)Page3.Parent).Remove(Page3);
    }
    Content = Page3;
};

2. 解决FlexLayout测量错误 #

FlexLayout的测量错误源于布局约束不完整，可通过以下调整修复：

• 给FlexLayout补充布局填充属性，确保能正确适配父容器：

var Page2 = new FlexLayout()
{
    AlignItems = FlexAlignItems.Center,
    Direction = FlexDirection.Column,
    WidthRequest = screen.Width / screen.Density,
    HorizontalOptions = LayoutOptions.Fill,
    VerticalOptions = LayoutOptions.Fill
};

• 给页面内的子控件（如按钮）补充尺寸约束，比如设置WidthRequest或HorizontalOptions = LayoutOptions.Center，帮助FlexLayout正确计算自身尺寸。

3. 更优雅的页面切换方案 #

推荐使用MAUI内置导航机制（NavigationPage或Shell）管理页面切换，自动处理页面生命周期与父容器关联，避免手动操作的潜在错误：

// NavigationPage示例
btn1.Pressed += async (s, e) =>
{
    await Navigation.PushAsync(new Page1());
};

注意：需将当前页面包装在NavigationPage中，或配置Shell路由实现导航。

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