为什么.NET MAUI应用Release版本CollectionView不显示内容，Debug版本正常？

我使用.NET 8.0构建.NET MAUI应用，默认配置下：

• Debug构建时，CollectionView能正常展示模型数据：
  
• Release构建后，模型中的文本和图片完全不显示，但设置CollectionView的BackgroundColor能生效，也能点击选择项，说明控件本身存在，仅数据未渲染：
  

相关代码与配置 #

模型代码 #

public partial class Product : ObservableObject, IIdentifiable
{
    [ObservableProperty]
    private Color _backgroundColor;

    public int Id { get; set; }
    
    public string Name { get; set; }

    public string Category { get; set; }
    
    public string Description { get; set; }
    
    public string ImageSource { get; set; }
}

ViewModel初始化代码 #

public partial class SelectProductPageViewModel : ObservableObject
{
//...
        public ObservableCollection<Product> Products { get; set; }

        public SelectProductPageViewModel(INavigationService navigationService, MobileCommanderDatabase database)
        {
            _navigationService = navigationService;
            _database = database;

            Products = new ObservableCollection<Product>()
            {
                new Product()
                {
                    Name = "Swings and Rockers",
                    Category = "Swings",
                    Description = "This is a baby swing",
                    ImageSource = "bb702a.png"
                },
            };
        }
//...

CollectionView XAML代码 #

<CollectionView Grid.Row="2"
                Grid.Column="0"
                x:Name="ProductCollectionView"
                ItemsSource="{Binding Products}"
                SelectionMode="Single"
                SelectedItem="{Binding SelectedProduct}"
                SelectionChangedCommand="{Binding ProductSelectedCommand}"
                SelectionChangedCommandParameter="{Binding SelectedItem, Source={x:Reference ProductCollectionView}}">
    <CollectionView.ItemTemplate>
        <DataTemplate x:DataType="domain:ProductModel">
            <Grid Padding="10"
                  BackgroundColor="{Binding BackgroundColor}">
                <Grid.RowDefinitions>
                    <RowDefinition Height="Auto" />
                    <RowDefinition Height="Auto" />
                </Grid.RowDefinitions>
                <Image Grid.Row="0"
                       Source="{Binding ImageSource}"
                       HeightRequest="150"
                       WidthRequest="150"
                       Aspect="AspectFit"
                       HorizontalOptions="Center"
                       VerticalOptions="Center" />
                <Label Grid.Row="1"
                       Text="{Binding Name}"
                       HorizontalOptions="Center"
                       VerticalOptions="Center" />
            </Grid>
        </DataTemplate>
    </CollectionView.ItemTemplate>
</CollectionView>

项目文件配置片段 #

<PropertyGroup Condition="'$(Configuration)|$(TargetFramework)|$(Platform)'=='Debug|net8.0-ios|AnyCPU'">
        <MtouchLink>None</MtouchLink>
    </PropertyGroup>

    <PropertyGroup Condition="'$(Configuration)|$(TargetFramework)|$(Platform)'=='Debug|net8.0-android|AnyCPU'">
      <EmbedAssembliesIntoApk>True</EmbedAssembliesIntoApk>
    </PropertyGroup>

    <PropertyGroup Condition="'$(TargetFramework)'=='net8.0-ios'">
        <CodesignKey>iPhone Distribution</CodesignKey>
        <CodesignProvision></CodesignProvision>
        <ProvisioningType>manual</ProvisioningType>
    </PropertyGroup>

问题原因分析 #

1. XAML编译时绑定类型不匹配
   XAML中DataTemplate的x:DataType="domain:ProductModel"，但实际绑定的模型类是Product，类型不一致。Release模式下.NET MAUI默认启用编译时绑定，类型不匹配会导致绑定静默失败；Debug模式下可能回退到运行时绑定，因此能正常显示。

2. 代码裁剪/链接器优化
   即使尝试禁用AOT和代码裁剪，仍需确认Release配置的链接器设置是否真正生效：

   • iOS：确保Release配置的MtouchLink设为None，避免模型类的属性被链接器移除；
   • Android：添加[Preserve]特性标记Product类或其属性，或通过Linker.xml配置保留该类型，防止R8压缩时丢失绑定所需的成员。

3. 图片资源问题
   检查bb702a.png的生成操作是否为MauiImage，且在Release配置下未被排除。Release构建时资源可能被优化，导致图片无法加载。

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