MAUI中ListView绑定自定义控件正常显示但运行时出现绑定错误

针对你遇到的问题——运行时提示在SummaryViewModel找不到ExerciseTime和RestTime，但数据能正常显示，且编译时绑定检查逻辑正确，以下是几种可行的解决思路：

1. 显式指定绑定的数据源 #

在DataTemplate中，通过RelativeSource明确绑定到ListViewItem的DataContext（即单个RoundViewModel实例），避免绑定系统错误地向上查找父级上下文：

<ListView ItemsSource="{Binding Rounds}">
    <ListView.ItemTemplate>
        <DataTemplate>
            <local:RoundView 
                ExerciseTime="{Binding ExerciseTime, RelativeSource={RelativeSource AncestorType={x:Type ListViewItem}}}" 
                RestTime="{Binding RestTime, RelativeSource={RelativeSource AncestorType={x:Type ListViewItem}}}"
            />
        </DataTemplate>
    </ListView.ItemTemplate>
</ListView>

2. 检查自定义控件的依赖属性定义 #

确保RoundView中的ExerciseTime和RestTime依赖属性注册正确，名称和类型与绑定的属性完全匹配：

public partial class RoundView : ContentView
{
    public static readonly BindableProperty ExerciseTimeProperty =
        BindableProperty.Create(
            nameof(ExerciseTime), 
            typeof(int), // 根据你的实际数据类型调整，比如TimeSpan
            typeof(RoundView), 
            defaultValue: default);

    public int ExerciseTime
    {
        get => (int)GetValue(ExerciseTimeProperty);
        set => SetValue(ExerciseTimeProperty, value);
    }

    // RestTime 依赖属性同理
    public static readonly BindableProperty RestTimeProperty =
        BindableProperty.Create(
            nameof(RestTime), 
            typeof(int), 
            typeof(RoundView), 
            defaultValue: default);

    public int RestTime
    {
        get => (int)GetValue(RestTimeProperty);
        set => SetValue(RestTimeProperty, value);
    }

    public RoundView()
    {
        InitializeComponent();
    }
}

如果依赖属性名称拼写错误、类型不匹配，绑定系统会尝试在父级上下文（SummaryViewModel）中查找属性，从而抛出错误。

3. 切换为编译时绑定{x:Bind} #

使用{x:Bind}替代{Binding}，它会在编译时严格检查绑定上下文和属性，避免运行时的上下文查找歧义：

<ListView ItemsSource="{Binding Rounds}">
    <ListView.ItemTemplate>
        <DataTemplate x:DataType="local:RoundViewModel">
            <local:RoundView 
                ExerciseTime="{x:Bind ExerciseTime}" 
                RestTime="{x:Bind RestTime}"
            />
        </DataTemplate>
    </ListView.ItemTemplate>
</ListView>

注意需要在DataTemplate中通过x:DataType明确指定上下文类型，{x:Bind}默认是OneWay模式，若需要双向绑定需显式添加Mode=TwoWay。

问题原因分析 #

这种矛盾情况的出现，大概率是MAUI Windows平台下ListView的DataTemplate在运行时的绑定上下文传递存在小概率歧义：编译时绑定检查能正确识别DataTemplate的上下文是RoundViewModel，但运行时绑定系统偶尔会错误地向上遍历到父级的SummaryViewModel查找属性。不过因为自定义控件的属性已经通过正确的绑定路径拿到了值，所以数据能正常显示，只是输出了错误日志。

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