MAUI应用非调试模式崩溃，TextColor引发InvalidCastException

问题场景 #

开发的MAUI应用在模拟器调试模式下运行正常，但在非调试模式（模拟器/物理设备）打开部分页面时崩溃。启用所有异常报告后，调试时触发大量InvalidCastException，栈信息指向XAML解析TextColor失败，即使删除了目标页面的所有TextColor赋值，异常仍会出现。

异常栈信息 #

System.InvalidCastException: Specified cast is not valid.
at Microsoft.Maui.Controls.TextElement.OnTextColorPropertyChanged(BindableObject bindable, Object oldValue, Object newValue) in D:\a_work\1\s\src\Controls\src\Core\TextElement.cs:line 24
at Microsoft.Maui.Controls.BindableObject.SetValueActual(BindableProperty property, BindablePropertyContext context, Object value, Boolean currentlyApplying, SetValueFlags attributes, SetterSpecificity specificity, Boolean silent) in D:\a_work\1\s\src\Controls\src\Core\BindableObject.cs:line 643
at Microsoft.Maui.Controls.BindableObject.SetValueCore(BindableProperty property, Object value, SetValueFlags attributes, SetValuePrivateFlags privateAttributes, SetterSpecificity specificity) in D:\a_work\1\s\src\Controls\src\Core\BindableObject.cs:line 569
at Microsoft.Maui.Controls.BindableObject.SetValue(BindableProperty property, Object value, SetterSpecificity specificity) in D:\a_work\1\s\src\Controls\src\Core\BindableObject.cs:line 503
at Microsoft.Maui.Controls.Setter.Apply(BindableObject target, SetterSpecificity specificity) in D:\a_work\1\s\src\Controls\src\Core\Setter.cs:line 81
at Microsoft.Maui.Controls.Style.ApplyCore(BindableObject bindable, Style basedOn, SetterSpecificity specificity) in D:\a_work\1\s\src\Controls\src\Core\Style.cs:line 176
at Microsoft.Maui.Controls.Style.Microsoft.Maui.Controls.IStyle.Apply(BindableObject bindable, SetterSpecificity specificity) in D:\a_work\1\s\src\Controls\src\Core\Style.cs:line 107
at Microsoft.Maui.Controls.MergedStyle.SetStyle(IStyle implicitStyle, IList`1 classStyles, IStyle style) in D:\a_work\1\s\src\Controls\src\Core\MergedStyle.cs:line 211
at Microsoft.Maui.Controls.MergedStyle.set_Style(IStyle value) in D:\a_work\1\s\src\Controls\src\Core\MergedStyle.cs:line 46
at Microsoft.Maui.Controls.NavigableElement.<>c.<.cctor>b__22_0(BindableObject bindable, Object oldvalue, Object newvalue) in D:\a_work\1\s\src\Controls\src\Core\Shell\NavigableElement.cs:line 21
at Microsoft.Maui.Controls.BindableObject.SetValueActual(BindableProperty property, BindablePropertyContext context, Object value, Boolean currentlyApplying, SetValueFlags attributes, SetterSpecificity specificity, Boolean silent) in D:\a_work\1\s\src\Controls\src\Core\BindableObject.cs:line 643
at Microsoft.Maui.Controls.BindableObject.SetValueCore(BindableProperty property, Object value, SetValueFlags attributes, SetValuePrivateFlags privateAttributes, SetterSpecificity specificity) in D:\a_work\1\s\src\Controls\src\Core\BindableObject.cs:line 569
at Microsoft.Maui.Controls.BindableObject.SetValue(BindableProperty property, Object value) in D:\a_work\1\s\src\Controls\src\Core\BindableObject.cs:line 474
at Microsoft.Maui.Controls.Xaml.ApplyPropertiesVisitor.TrySetValue(Object element, BindableProperty property, Boolean attached, Object value, IXmlLineInfo lineInfo, IServiceProvider serviceProvider, Exception& exception) in D:\a_work\1\s\src\Controls\src\Xaml\ApplyPropertiesVisitor.cs:line 631

解决方案 #

从异常栈能看出，问题出在Style的Setter设置TextColor时类型转换失败，并非页面直接的TextColor赋值导致——你删除页面赋值后未解决，说明样式来自全局资源、隐式样式或继承的样式。按以下步骤排查：

• 检查全局资源字典/App.xaml中的样式：查找所有针对TextElement、Label、Button等控件的Style，确认TextColor的Setter值是否为错误类型。比如是否直接写字符串（如"Red"而非Color.Red或#FF0000），或绑定的属性不是Color类型。
• 排查样式继承（BasedOn）：如果某个样式使用了BasedOn，需检查父样式中的TextColor设置是否存在问题，继承链中任意一层出错都会触发异常。
• 验证绑定的TextColor值：若使用绑定，调试时查看newValue的实际类型——大概率是绑定到了string或int，而非Color对象。可临时将绑定替换为硬编码的Color值，验证是否仍报错。
• 清理编译缓存并重建：右键项目选择「清理」，删除bin/obj文件夹，重启Visual Studio后重新生成项目。旧的XAML编译残留可能导致此类奇怪的类型错误。
• 启用XAML诊断定位具体元素：在项目的.csproj文件中添加以下配置，编译后调试时会显示更详细的XAML元素定位信息，直接找到触发异常的样式或控件：

  <PropertyGroup>
    <EnableXamlDiagnosticsInformation>True</EnableXamlDiagnosticsInformation>
  </PropertyGroup>
  

• 逐步排查样式：先临时注释所有全局样式，确认是否还崩溃。若恢复正常，再逐个恢复样式，定位到触发异常的那一个，随后修正其TextColor设置。

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