如何自定义Blazor参数变更检测行为？

问题背景 #

已知Blazor的参数变更检测规则：父组件调用StateHasChanged后，Blazor会对内置支持的显式检测类型判断是否变更，对于未纳入检测的自定义类型，会直接触发子组件重渲染。由于Blazor内部的ChangeDetection代码是internal无法直接修改，计划通过自定义组件在SetParametersAsync方法中二次检查参数，若参数无变更则提前返回以避免不必要的重渲染。

核心疑问 #

1. 是否有现成的实现示例？
2. 使用反射检查参数时如何保证性能？

一、可复用的实现示例 #

你可以封装一个基类组件，让需要自定义变更检测的业务组件继承它，在基类中统一实现参数对比逻辑。以下是完整的可运行实现：

1. 自定义参数检测基类 #

using Microsoft.AspNetCore.Components;
using System.Reflection;
using System.Collections.Generic;

public class ChangeDetectComponentBase : ComponentBase
{
    // 存储上一次的参数快照，用于对比
    private Dictionary<string, object> _lastParameterValues = new();
    // 静态缓存：存储类型对应的公共属性信息，避免重复反射
    private static readonly Dictionary<Type, PropertyInfo[]> _typePropertyCache = new();

    public override async Task SetParametersAsync(ParameterView parameters)
    {
        bool needUpdate = false;

        // 遍历所有传入参数，逐一对比变更
        foreach (var param in parameters)
        {
            var paramName = param.Name;
            var currentValue = param.Value;

            if (_lastParameterValues.TryGetValue(paramName, out var lastValue))
            {
                // 参数已存在，对比值是否变更
                if (!AreValuesEqual(lastValue, currentValue))
                {
                    needUpdate = true;
                    _lastParameterValues[paramName] = currentValue;
                }
            }
            else
            {
                // 首次传入该参数，标记需要更新并记录
                needUpdate = true;
                _lastParameterValues[paramName] = currentValue;
            }
        }

        // 无变更则直接返回，跳过渲染流程
        if (!needUpdate)
        {
            return;
        }

        // 调用基类方法完成正常参数设置与渲染
        await base.SetParametersAsync(parameters);
    }

    // 自定义值对比逻辑：优先使用类型原生相等判断， fallback到反射
    private bool AreValuesEqual(object lastValue, object currentValue)
    {
        // 处理null场景
        if (lastValue == null && currentValue == null) return true;
        if (lastValue == null || currentValue == null) return false;

        var valueType = lastValue.GetType();
        // 值类型/字符串直接用Equals对比
        if (valueType.IsValueType || valueType == typeof(string))
        {
            return lastValue.Equals(currentValue);
        }

        // 自定义类型优先调用IEquatable<T>实现
        if (lastValue is IEquatable<object> equatable)
        {
            return equatable.Equals(currentValue);
        }

        // 最后fallback到反射对比对象属性
        return AreObjectsEqualViaReflection(lastValue, currentValue);
    }

    // 反射对比对象公共属性的逻辑
    private bool AreObjectsEqualViaReflection(object obj1, object obj2)
    {
        var objType = obj1.GetType();
        if (objType != obj2.GetType()) return false;

        // 从缓存获取属性信息，无则反射获取并缓存
        var properties = _typePropertyCache.GetOrAdd(objType, 
            t => t.GetProperties(BindingFlags.Public | BindingFlags.Instance));

        foreach (var prop in properties)
        {
            var val1 = prop.GetValue(obj1);
            var val2 = prop.GetValue(obj2);
            if (!AreValuesEqual(val1, val2))
            {
                return false;
            }
        }
        return true;
    }
}

2. 业务组件使用示例 #

让你的自定义组件继承上述基类，即可自动启用自定义变更检测：

public partial class UserProfileCard : ChangeDetectComponentBase
{
    [Parameter]
    public UserInfo User { get; set; } // 自定义类型，无需Blazor内置支持

    [Parameter]
    public bool IsEditable { get; set; } // 内置类型，自动兼容原有检测
}

二、反射检查的性能优化方案 #

反射本身存在一定性能开销，可通过以下手段将影响降到最低：

• 静态缓存属性元数据：使用静态字典缓存类型的公共属性信息，仅在首次处理某类型时执行反射，后续直接复用缓存结果，避免重复反射开销。
• 优先使用类型原生相等判断：要求自定义类型实现IEquatable<T>接口，直接调用类型原生的Equals方法，完全绕过反射。仅当类型未实现该接口时，才 fallback 到反射对比。
• 缩小反射范围：只对比公共实例属性，跳过私有成员、静态成员、方法等非数据成员，减少反射的工作量。
• 按需控制对比深度：对于包含嵌套对象的自定义类型，可限制递归对比的深度，或者只对比核心业务属性，避免不必要的深层反射。
• 选择性启用反射：对于变更频率极低的自定义参数，可手动跳过反射对比，直接视为无变更，进一步减少性能消耗。

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