CODE Polyglot のサイトが検索エンジンにどれだけ登録されているかを調べる、小さなスクリプトを書きました。URL を1つずつ調べるので、名前は inspect.py にしました。動かすと、1行目の import で止まりました。
何が起きたか
同じ形を、いちばん小さく作り直しました。
# inspect.py
from concurrent.futures import ThreadPoolExecutor
print("URL を調べます")
$ python3 inspect.py
URL を調べます
Traceback (most recent call last):
File "./inspect.py", line 1, in <module>
from concurrent.futures import ThreadPoolExecutor
File "…/lib/python3.14/concurrent/futures/_base.py", line 7, in <module>
import logging
(途中を省略)
File "…/lib/python3.14/dataclasses.py", line 5, in <module>
import inspect
File "./inspect.py", line 1, in <module>
from concurrent.futures import ThreadPoolExecutor
ImportError: cannot import name 'ThreadPoolExecutor' from partially initialized module 'concurrent.futures' (most likely due to a circular import)
終了コードは 1 です。ところが、エラーの前に「URL を調べます」が出ています。1行目で止まったはずのスクリプトの、最後の print です。
ファイルの名前を check_urls.py に変えるだけで、エラーは出なくなりました。
原因:標準ライブラリの inspect の代わりに、自分のファイルが読み込まれた
python3 inspect.py で動かすと、Python はスクリプトのあるフォルダを import の探し先の先頭に入れます。
concurrent.futures を読み込むと、その中で logging、さらに dataclasses が読み込まれます。dataclasses は標準ライブラリの inspect を使います。ところが探し先の先頭に同じ名前の自分のファイルがあるので、そちらを読み込みました。
読み込まれた自分の inspect.py は、1行目でまた concurrent.futures を読み込もうとします。このときは concurrent.futures がまだ読み込みの途中なので、ThreadPoolExecutor が見つからず、ImportError になりました。
3回読み込まれていた
読み込まれるたびに名前を出すよう、先頭に2行足し、最後の print にも名前を足しました。
import sys
print("読み込み:", __name__, file=sys.stderr)
from concurrent.futures import ThreadPoolExecutor
print("URL を調べます", __name__)
読み込み: __main__
読み込み: inspect
読み込み: inspect
URL を調べます inspect
Traceback (most recent call last):
(以下、上と同じエラー)
- 1回目は、動かしたスクリプトとして(
__main__)読み込まれた - 2回目は、
dataclassesのimport inspectで読み込まれ、途中で失敗した - 3回目は、エラーの文が出る前に、もう一度
inspectとして読み込まれた。このときは最後まで動いて「URL を調べます」と出した(エラーを表示する仕組みが標準のinspectを使おうとしたためとみられる)
エラーで止まったのに、処理の一部が動いていたことになります。出力をパイプでほかのプログラムに渡すと、「URL を調べます」はエラーの後ろに回り、順番からも気づきにくくなります。
どう直したか
ファイルの名前を変えました。名前を変えたあとは、__pycache__ に inspect.cpython-314.pyc が残っていても、問題なく動きました。
標準ライブラリと同じ名前かどうかは、名前を決める前にこう確かめられます。
$ python3 -c 'import sys; print("inspect" in sys.stdlib_module_names)'
True
$ python3 -c 'import sys; print("check_urls" in sys.stdlib_module_names)'
False
名前を変えられないときは、python3 -P inspect.py で動かす方法もあります。-P をつけると、スクリプトのあるフォルダを探し先に入れないので、手元の Python 3.14.7 ではエラーが出ずに動きました。ただし、同じフォルダに置いた自分のモジュールも読み込まれなくなります。
まとめ
- スクリプトに標準ライブラリと同じ名前(
inspect.py・logging.py・random.pyなど)をつけると、標準ライブラリの中の import が自分のファイルを読み込む - 今回は自分のファイルが3回読み込まれ、ImportError で止まったうえに、最後の print まで動いた
- 名前は
sys.stdlib_module_namesで先に確かめる
Analyzegear


