python · Python

メッセージ

ImportError: cannot import name 'User' from partially initialized module 'models' (most likely due to a circular import)

何を意味するか

二つのモジュールが互いを import しているため、まだ半分しか読み込まれていないモジュールから名前を取り出そうとしています。A が B を、B が A を呼ぶ形で起こり、ファイルを分けた直後に型ヒントのために import を戻すときによく出ます。from y import Thing を import y に変え、関数の中で y.Thing と書けば参照が後ろにずれ、循環が問題になりません。

直しかた

一行の命令では終わりません。何を見るべきかを説明に書いてあります。

出す道具
python
Python
18

Python のトレースバックは答えを二つに分けて置きます — 最後の一行が何が誤りかを、その上のフレームがどこで誤ったかを示すので、最後の行だけ読むと名前は分かって場所を落とします。とくに NoneType や KeyError のように値が無くて出る誤りは、落ちた場所より、その値を作った上のフレームに原因があります。

エラーメッセージの読み方

  • 一行目から読みます。下に行くほど道具の内部の話で、原因はたいてい一番上に書かれています。
  • ファイル名と行番号があればそこが出発点です — スタックの最上段ではなく、自分が書いたファイルが出てくる一番上の行です。
  • 文句はそのまま検索します。ただし自分のパスや変数名は消します — その部分が検索を邪魔します。
  • 同じ事情が道具の版ごとに違う言い方で出ます。結果が合わないときは版番号も入れてみます。
  • 直す命令を貼る前に、その命令が何を捨てるかを確かめます。取り消せないものが混ざっています。

よくある質問

Q. ImportError: cannot import name 'User' from partially initialized module 'models' (most likely due to a circular import) はどういう意味ですか。

二つのモジュールが互いを import しているため、まだ半分しか読み込まれていないモジュールから名前を取り出そうとしています。A が B を、B が A を呼ぶ形で起こり、ファイルを分けた直後に型ヒントのために import を戻すときによく出ます。from y import Thing を import y に変え、関数の中で y.Thing と書けば参照が後ろにずれ、循環が問題になりません。

Q. どう直しますか。

一行の命令では終わりません。何を見るべきかを上の説明に書いてあります。

Q. どの道具が出すエラーですか。

python です。Pythonの仲間で、文句は17語です。

近いエラー