如何为Python类对象生成确定性哈希值？

问题成因 #

默认情况下Python类对象的哈希值基于其内存地址计算，PYTHONHASHSEED环境变量仅对str、bytes等内置类型的哈希加盐逻辑生效，不会影响基于内存地址的哈希结果。操作系统的ASLR（地址空间布局随机化）机制会让每次程序启动时类的加载地址发生变化，最终导致类对象哈希值每次运行都不相同。 #

方案1：通过元类为自定义类生成确定性哈希 #

你可以通过自定义元类，重写类对象的__hash__方法，基于类的唯一标识属性（如模块名、限定名）计算哈希值，此方案仅对你自己定义的类生效：

class DeterministicHashMeta(type):
    def __hash__(cls):
        # 可根据业务需要调整哈希计算的参数，避免同模块同名类冲突
        return hash((cls.__module__, cls.__qualname__))

# 自定义类指定使用该元类即可
class Before(metaclass=DeterministicHashMeta):
    pass
class Equation(metaclass=DeterministicHashMeta):
    pass

方案2：覆盖所有类（含内置类）的哈希逻辑 #

CPython禁止修改内置类型的特殊方法，因此无法通过猴子补丁或者修改元类的方式直接更改int等内置类的哈希规则，只能通过上层封装的方式实现全局确定性哈希，有两种常用实现方式：

方式A：对象包装器 #

将所有要存入集合的对象用自定义包装类包裹，在包装类中统一处理哈希逻辑：

class HashableWrapper:
    def __init__(self, obj):
        self.obj = obj
    
    def __hash__(self):
        # 类对象用自定义规则计算哈希
        if isinstance(self.obj, type):
            return hash((self.obj.__module__, self.obj.__qualname__))
        # 其他类型用默认哈希
        return hash(self.obj)
    
    def __eq__(self, other):
        if isinstance(other, HashableWrapper):
            return self.obj == other.obj
        return self.obj == other

# 使用示例
s = set()
s.add(HashableWrapper(Before))
s.add(HashableWrapper(int))
print(HashableWrapper(int) in s) # 结果确定

方式B：自定义集合类 #

直接重写集合的存取逻辑，无需修改上层代码：

class DeterministicSet(set):
    def _process_obj(self, obj):
        if isinstance(obj, type):
            return (obj.__module__, obj.__qualname__)
        return obj
    
    def add(self, obj):
        super().add(self._process_obj(obj))
    
    def __contains__(self, obj):
        return self._process_obj(obj) in super()
    
    def remove(self, obj):
        super().remove(self._process_obj(obj))

# 使用示例
s = DeterministicSet()
s.add(Before)
s.add(int)
print(int in s) # 结果确定

注意事项 #

如果你的业务中存在同模块下同名的动态生成类，可在哈希计算逻辑中加入额外的唯一标识（如类的注解、自定义类ID等），避免哈希冲突。

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