C#实现IEquatable接口时可能空引用警告的解决方法

安全阿岳

2026-9-2

问题根因

警告触发的核心原因是自定义相等运算符的参数可空性声明错误：

你实现的==/!=运算符参数声明为不可空类型SubscriptionToken，但.NET约定相等运算符必须支持两侧操作数为null的判断场景，该声明本身不符合设计规范。
当Equals方法中执行other != null判断时，编译器会优先调用自定义的!=运算符，此时传入的other是可空类型SubscriptionToken?，将可能为null的值传入声明为不可空的运算符参数，就会触发"可能传入空引用"的静态分析警告。

修复方案

两种方案均符合C#可空上下文编码规范，可彻底消除警告，按需选择即可：

方案1：使用`is not null`模式匹配做非空校验（推荐）

模式匹配的空判断不会调用自定义重载运算符，编译器可直接识别非空校验逻辑，无需改动其他代码，仅需调整Equals方法：

public bool Equals(SubscriptionToken? other)
{
    return other is not null && _guid == other._guid;
}

该写法是C# 7.0+版本推荐的标准非空判断方式，可完全规避自定义运算符重载对静态空分析的干扰。

方案2：修正运算符的可空性声明

将两个重载运算符的参数修改为可空类型，既符合相等运算符支持null操作数的设计约定，也能让编译器识别参数允许传入null，从根源消除警告。修改后的运算符代码如下：

public static bool operator ==(SubscriptionToken? left, SubscriptionToken? right)
{
    return EqualityComparer<SubscriptionToken>.Default.Equals(left, right);
}

public static bool operator !=(SubscriptionToken? left, SubscriptionToken? right)
{
    return !(left == right);
}

修改后原有other != null的写法无需调整，编译器不会再抛出空引用相关警告。