Pythonクラス間の循環依存を解決する方法｜原因と回避策をわかりやすく解説

Pythonクラス間の循環依存とは？

Pythonでは、複数のクラスが互いに参照し合う「循環依存」が発生することがあります。次のコードは、PとQという2つのクラスが互いのメソッドを呼び出そうとして、循環依存が起きている典型例です。

class P():
    q = Q().do_something()
    def do_something(self):
        pass

class Q():
    p = P().do_something()
    def do_something(self):
        pass

一見正しく見えますが、このコードはそのままでは動作しません。なぜなら、クラスの本体（ボディ）は定義された時点で即座に実行されるからです。クラスPを定義するためにはQのメソッドを実際に呼び出す必要がありますが、その時点ではまだクラスQが定義されていないため、NameErrorが発生してしまいます。

解決策：クラス定義後に属性を追加する

この問題を回避するシンプルな方法は、まず両方のクラスを空の状態で定義しておき、その後で必要な属性を後付けすることです。

class P(object):
    pass

class Q(object):
    pass

P.q = Q.do_something()
Q.p = P.do_something()

Pythonは動的な言語なので、このようにクラスの定義が完了した後でも、属性やメソッドを自由に追加できます。これにより、定義順序による循環参照の問題を回避できます。

注意点：相互に依存する処理の場合

ただし、この方法にも限界があります。それぞれのdo_something()の呼び出しが「相手側の呼び出しがすでに実行済みであること」に依存している場合、上記の方法では正常に動作しません。その場合は、処理の内容や呼び出しのタイミング自体を見直すなど、さらなる設計変更が必要になります。

根本原因：クラスレベルの文は定義時に実行される

そもそもこの問題が起こる理由は、q = Q.do_something() のようなクラスレベルの記述が、インスタンス生成時ではなくクラス定義時に実行されるためです。関数の本体は呼び出されるまで実行されませんが、クラスの本体は異なります。もし各インスタンスごとに実行したい処理であれば、__init__メソッド内に移動することを検討するとよいでしょう。

まとめ

Pythonでは、両方のクラスが定義された後であれば、クラスの定義を後から補完・拡張できます。これはPythonが柔軟な動的言語であることの証左でもあります。循環依存に直面した際は、「クラス定義の順序」と「コードが実行されるタイミング」の2点を見直すことが、問題解決の鍵となります。