Python中dependency_injector的DeclarativeContainer继承为何失效？

Python中继承普通类时，添加自定义实例方法可以正常调用，但继承dependency_injector库的DeclarativeContainer后，实例化容器并调用自定义方法会报错，提示操作的是DynamicContainer对象且无该方法。

复现代码 #

from dependency_injector import containers

class Container(containers.DeclarativeContainer):
    def printContainer(self):
        print(f'Hello from container!')

if __name__ == "__main__":
    container = Container()
    container.printContainer()  # 此处报错

报错信息 #

AttributeError: 'DynamicContainer' object has no attribute 'printContainer'

原因分析 #

DeclarativeContainer的__new__方法被重写了，当你实例化自定义的Container类时，它并不会返回Container类的实例，而是返回一个DynamicContainer的实例。这个动态生成的容器对象只继承了DeclarativeContainer中定义的依赖配置，不会包含你添加的自定义实例方法，因此调用时会触发属性不存在的错误。

这是dependency_injector库的设计逻辑：DeclarativeContainer仅作为依赖结构的声明载体，实际运行时的容器实例由库动态生成，用于管理依赖的注入和生命周期。

解决方案 #

方案1：使用类方法/静态方法替代实例方法 #

如果只是需要给容器添加工具类逻辑，将方法定义为类方法或静态方法，直接通过类调用即可：

from dependency_injector import containers

class Container(containers.DeclarativeContainer):
    @classmethod
    def printContainer(cls):
        print(f'Hello from container!')

if __name__ == "__main__":
    # 直接通过类调用方法
    Container.printContainer()
    
    # 实例化后也可以通过类调用，不受DynamicContainer影响
    container = Container()
    Container.printContainer()

方案2：通过组合方式扩展容器功能 #

如果需要在实例层面扩展功能，可以将容器实例和自定义逻辑类组合使用，避免直接修改DeclarativeContainer子类：

from dependency_injector import containers

class Container(containers.DeclarativeContainer):
    # 这里定义依赖配置
    pass

class ContainerUtils:
    def __init__(self, container):
        self.container = container
    
    def printContainer(self):
        print(f'Hello from container!')

if __name__ == "__main__":
    container = Container()
    utils = ContainerUtils(container)
    utils.printContainer()

注意事项 #

不要试图在DeclarativeContainer子类中添加实例方法，这违背了库的设计初衷，后续版本可能会引发更多兼容性问题。优先使用类方法、静态方法或组合的方式扩展功能。

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