Pythonのバージョンを上げて、古いコードベースを動かした時、「AttributeError: module 'pkgutil' has no attribute 'impimporter'」というエラーが出てハマった話です。動的インポート処理をしている箇所で引っかかりましたが、これはPythonのインポートシステムの変遷に関わる避けられない問題でした。
何が起きたか（課題）
Python 3.12以降でこのエラーが発生する理由は、古いインポート機構であるimpモジュールが標準ライブラリから完全に削除されたためです。具体的には以下のコードが原因でした。
-
pkgutil.impimporterという属性にアクセスしようとすると、内部参照が切れてエラーとなる。 - これはPython 3.4以降非推奨となっていた古いAPIへの依存が原因。
- 動的インポートやプラグイン機構を持つコードがバージョンアップで動かなくなるリスクがあった。
どう解決したか（概要）
この問題を解決する唯一の方法は、非推奨のAPIから脱却し、現在の標準であるimportlibモジュールへ全面的に移行することです。古いimpimporterの代わりに、importlib.import_module()を使用するアプローチを取りました。
まず、エラーが発生したコードのパターンを特定しました。多くの場合、特定のモジュールを文字列で指定して動的に読み込む処理で発生していました。
移行手順は以下の通りです。
-
import pkgutilだった箇所を特定し、import importlibに変更する。 -
pkgutil.impimporterを使用していた箇所を、importlib.import_module('モジュール名')に置き換える。 - 動的インポートは失敗する可能性があるため、
try...except ImportErrorブロックで囲み、EAFP原則に基づいて堅牢なコードにする。
例えば、動的インポートの基本形は以下のようになります。
import importlib
module_name = 'target_module_name'
module = importlib.import_module(module_name)
このアプローチにより、将来のPythonバージョンでも安定して動作するコードベースを確保できました。
🚀 詳細な設定とコードはこちら
具体的なエラー発生時のコード例と、ネストされたモジュールを安全にインポートするための完全なヘルパー関数の実装、そしてインポータークラスが必要な場合のimportlib.machineryの使い方など、より詳細な技術的背景とコードスニペットは元のブログで公開しています。