.NET MAUI中BoxView设置BackgroundColor无效始终为黑色如何解决

• 最常见的原因是BoxView控件自带专属的Color属性，这个属性的渲染优先级远高于所有VisualElement通用的BackgroundColor属性，而BoxView.Color的默认值恰好是Colors.Black。很多开发者刚接触MAUI时会习惯性设置BackgroundColor，但只要没修改Color属性，控件填充色就会始终取默认的黑色，这个表现是跨平台统一的，和Windows、Android的平台渲染逻辑无关。
• 其他可能的触发场景：项目全局样式、当前页面资源字典里定义了BoxView的隐式样式，强制把Color设为黑色覆盖了本地设置；.NET 6、.NET 7早期版本存在BoxView渲染管线bug，会忽略自定义颜色值强制渲染为黑色。

按以下优先级排查修复即可：

• 优先直接用BoxView自带的Color属性设置填充色，不需要设置BackgroundColor，参考代码：

<BoxView 
    WidthRequest="150"
    HeightRequest="150"
    Color="#2196F3"
    HorizontalOptions="Center"
    VerticalOptions="Center" />

• 如果有特殊场景必须用BackgroundColor控制填充色，需要显式把BoxView.Color设为透明，让底层背景色透出来，参考代码：

<BoxView 
    WidthRequest="150"
    HeightRequest="150"
    Color="Transparent"
    BackgroundColor="#4CAF50"
    HorizontalOptions="Center"
    VerticalOptions="Center" />

• 检查项目Resources/Styles/Styles.xaml以及当前页面的资源字典，是否存在没有指定x:Key的BoxView隐式样式，里面写了<Setter Property="Color" Value="Black"/>这类强制赋值，要么删除这个全局Setter，要么给需要自定义颜色的BoxView设置本地属性值覆盖全局配置。
• 以上操作都无效的话，检查当前安装的MAUI SDK版本，升级到.NET 7 SR2以上或者.NET 8正式版，清理项目下的bin、obj文件夹后重新生成，即可修复早期版本的渲染bug。

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