.NET MAUI iOS发布模式崩溃：SolidColorBrush已属于Scheduler.HeaderLayout

问题根源分析 #

你遇到的崩溃和调试时的警告直接相关：SolidColorBrush实例被重复添加到Scheduler的HeaderLayout视觉树中。这是因为Appointment类的Background属性每次调用都会创建新的SolidColorBrush实例，而Syncfusion Scheduler在发布模式（尤其是AOT编译优化下）处理Brush绑定时，会出现视觉树元素重复添加的冲突，调试模式仅触发警告但不会崩溃。此外，新增的SKLottieView资源也可能在发布模式下未正确打包，加剧崩溃概率。

分步解决方案 #

1. 替换Brush绑定为Color绑定（核心修复） #

Syncfusion Scheduler的AppointmentMapping.Background支持直接绑定Color类型，内部会自动处理Brush的创建，避免外部传入Brush导致的视觉树冲突：

• 修改Appointment类，新增Color类型的属性替代Brush：

public class Appointment
{
    public string Id { get; set; }
    public string Name { get; set; }
    public bool Own { get; set; }
    public DateTime From { get; set; }
    public DateTime To { get; set; }
    
    public int BackgroundInt { get; set; }

    [NotMapped]
    public Color BackgroundColor
    {
        get
        {
             return Color.FromArgb($"000000{BackgroundInt:X}"[^6..]);
        }
    }
}

• 更新XAML中的AppointmentMapping：

<syncfusion:SfScheduler.AppointmentMapping>
    <syncfusion:SchedulerAppointmentMapping
        Id="Id"
        Subject="Name"
        StartTime="From"
        EndTime="To"
        Background="BackgroundColor"/>
</syncfusion:SchedulerAppointmentMapping>

2. 确保SKLottieView资源正确嵌入 #

检查animation_loading.json的文件属性：

• 设置生成操作为MauiAsset
• 设置复制到输出目录为如果较新则复制
  这能避免发布模式下资源丢失导致的加载失败。

3. 临时禁用AOT编译验证（可选） #

如果崩溃仍存在，可临时关闭iOS发布模式的AOT编译，确认是否是AOT优化导致的问题：
在项目的csproj文件中添加：

<PropertyGroup Condition="'$(Configuration)|$(TargetFramework)|$(Platform)'=='Release|net7.0-ios|AnyCPU'">
    <UseAOT>false</UseAOT>
</PropertyGroup>

若禁用后崩溃消失，说明AOT优化对Brush创建逻辑产生了影响，方案1的Color绑定方式可彻底解决该问题。

4. 获取详细崩溃日志（排查辅助） #

若以上方案无效，可通过Xcode Organizer查看设备崩溃报告，或在AppDelegate中添加全局异常捕获：

public override bool FinishedLaunching(UIApplication app, NSDictionary options)
{
    AppDomain.CurrentDomain.UnhandledException += (sender, e) =>
    {
        var logPath = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments), "crash.log");
        File.WriteAllText(logPath, e.ExceptionObject.ToString());
    };
    
    TaskScheduler.UnobservedTaskException += (sender, e) =>
    {
        var logPath = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments), "task_crash.log");
        File.WriteAllText(logPath, e.Exception.ToString());
        e.SetObserved();
    };
    
    return base.FinishedLaunching(app, options);
}

日志会保存到设备的Documents目录，可通过Xcode导出查看具体崩溃堆栈。

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