Python 3.4+ post import hook正确实现方法及运行报错解决方案

1. 代码报错原因 #

核心错误为sys.meta_path插入的对象类型不符合要求：sys.meta_path需要存储导入查找器的实例对象，你直接插入了PostImportFinder类本身。
当Python导入系统调用查找器的find_spec方法时，未实例化的类不会自动绑定self参数，find_spec定义的第一个参数self实际接收到的值是第一个入参fullname（模块全名字符串），因此访问self._skip等价于在字符串上访问不存在的_skip属性，触发你遇到的报错。

修复步骤 #

1. 修改postimport.py最后一行代码，实例化查找器后再插入sys.meta_path：

# 原代码：sys.meta_path.insert(0,PostImportFinder)
sys.meta_path.insert(0, PostImportFinder())

2. 删除postimport.py开头多余的空import语句，避免语法错误。
3. 补充PostImportLoader的exec_module方法，符合importlib的实现规范：

class PostImportLoader:
    def __init__(self, finder):
        self._finder = finder
    
    def create_module(self, spec):
        importlib.import_module(spec.name)
        module = sys.modules[spec.name]
        for func in _post_import_hooks[spec.name]:
            func(module)
        self._finder._skip.remove(spec.name)
        return module
    
    # 新增空的exec_module方法
    def exec_module(self, module):
        pass

你已经在create_module中通过importlib.import_module完成了模块的加载执行，不需要重复执行模块代码，所以该方法留空即可。

2. 更优的post import实现方案 #

• 若可升级到Python 3.10及以上版本，可直接使用标准库importlib.util内置的register_post_import_hook函数，无需自行实现底层导入钩子，原生实现稳定性和兼容性更强。
• 若需要兼容Python 3.7版本，可选择两种方案：
  • 自定义sys.modules代理类，监听字典插入操作，当目标模块被加入sys.modules时触发钩子，实现逻辑更简单，不需要侵入导入系统底层。
  • 采用成熟第三方库内置的post import hook能力，这类实现经过大量生产环境验证，兼容性比手写导入钩子更好。

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