如何避免Python类属性初始化时触发对象构造的副作用

现有如下代码：

from functools import partial

def get_data(query):
    result = query.search()
    print(result)
    return result

class Query:
    def __init__(self):
        print('side effect')

    def search(self):
        print('searching')
        return '123'

class News:
    sourcing_handler = staticmethod(partial(get_data, query=Query()))

    def source(self):
        self.sourcing_handler()

news = News()

执行上述代码时，哪怕只是完成News类的定义、还未实例化News对象，就会打印side effect。核心原因是Python类体内的顶层代码会在类定义阶段直接执行，sourcing_handler = staticmethod(partial(get_data, query=Query()))这行里的Query()会被立刻调用，和后续是否实例化类、是否调用查询方法完全无关。

提问中提到的静态方法改写方式存在接口不一致的问题：该写法下调用sourcing_handler()只会返回绑定好的partial对象，并不会实际执行查询逻辑，需要额外加一层括号调用才能得到结果，破坏了原有接口的使用习惯，声明性也较差。

核心思路是把Query()的初始化时机从「类定义阶段」延迟到「第一次实际调用sourcing_handler时」，同时完全保留原有接口的调用逻辑，不需要修改source方法的代码。
最符合声明性要求的方案是实现一个通用的懒加载描述符，一次实现后可以在所有需要延迟初始化静态类属性的场景复用：

from functools import partial

def get_data(query):
    result = query.search()
    print(result)
    return result

class Query:
    def __init__(self):
        print('side effect')

    def search(self):
        print('searching')
        return '123'

# 通用懒加载静态属性描述符
class LazyStaticAttribute:
    def __init__(self, value_factory):
        self.value_factory = value_factory
        self._value = None
        self._initialized = False

    def __get__(self, instance, owner):
        if not self._initialized:
            self._value = self.value_factory()
            self._initialized = True
        return self._value

class News:
    # 声明式写法，传入值构造工厂，类定义阶段不会执行内部逻辑
    sourcing_handler = LazyStaticAttribute(lambda: partial(get_data, query=Query()))

    def source(self):
        self.sourcing_handler()

方案优势 #

• 完全兼容原有接口：source方法不需要做任何修改，调用sourcing_handler()的行为和原写法完全一致
• 初始化时机符合预期：类定义、实例化News的阶段都不会触发Query的初始化，只有第一次实际访问sourcing_handler时才会执行Query()打印side effect
• 语义对齐原逻辑：Query只会被初始化一次，后续所有调用都复用同一个实例，和原来类属性只初始化一次的行为完全一致
• 通用性强：LazyStaticAttribute是通用描述符，项目中其他需要延迟初始化的静态类属性都可以直接用这个写法，不需要重复写冗余的静态方法包装代码。

其他可选方案 #

如果业务场景不需要全局复用同一个Query实例，希望每次调用查询都生成新的Query对象，可以直接用普通静态方法实现，写法更简单：

class News:
    @staticmethod
    def sourcing_handler():
        return get_data(Query())

    def source(self):
        self.sourcing_handler()

这个写法同样不会在类定义阶段触发side effect，只是每次调用都会重新初始化Query实例，适合Query实例不需要复用的场景。

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