插件基类必须继承abc.ABC并用@abstractmethod标记initialize、execute、shutdown等关键方法，否则子类漏实现仅在实例化时抛TypeError，调试成本高；需配合isinstance/issubclass双重校验、安全导入及异常隔离机制。
插件基类必须用 ABC 和 @abstractmethod 强制约束
不加抽象约束的基类等于没约定——子类可以随意漏实现方法，运行时才报错，调试成本高。必须用 abc.ABC 显式声明，并对每个关键方法打上 @abstractmethod 标签。
常见错误是只写文档说“请实现 execute”，结果新插件忘了写，加载后调用直接 NotImplementedError 崩溃，而且堆栈里看不出是哪个插件出的问题。
-
initialize、execute、shutdown这三个生命周期方法建议全标为抽象，哪怕某些插件不需要初始化，也强制写个空实现，统一调用链路 - 避免在基类里提供默认实现（比如空的
def shutdown(self): pass），否则会掩盖未实现意图 - 类型提示要写实：比如
def execute(self, data: dict) -> dict:，别用Any或省略，IDE 和 mypy 才能提前捕获参数结构错位
插件发现时必须过滤掉基类本身和测试类
用 issubclass(obj, PluginBase) 扫描模块时，PluginBase 自身也会被匹配到，实例化时报 TypeError: Can't instantiate abstract class。更隐蔽的是，如果插件文件里写了 TestPlugin(PluginBase) 这类测试类，也会被误加载。
实操中必须加双重校验：
立即学习“Python免费学习笔记（深入）”；
- 先用
isinstance(obj, type)确保是类对象，不是函数或变量 - 再用
issubclass(obj, PluginBase) and obj is not PluginBase排除基类自身 - 最后检查类名是否以
"Test"或"Mock"开头，或是否有__test__ = False这类标记（推荐在插件类里显式加该属性）
importlib.import_module 的模块路径容易拼错
错误常出现在两个地方：一是把 plugins/hello.py 当成模块名传给 importlib.import_module("hello")，但实际需要的是 Python 包路径；二是没把 plugins/ 目录加进 sys.path 或没设为包（缺 __init__.py）。
安全做法是用 importlib.util.spec_from_file_location + module_from_spec，绕过路径解析依赖：
spec = importlib.util.spec_from_file_location(module_name, file_path) module = importlib.util.module_from_spec(spec) spec.loader.exec_module(module)
-
module_name可任意取（如f"plugin_{uuid4().hex}"），不依赖文件系统结构 - 完全避开
sys.path干扰，适合沙箱环境或非标准目录布局 - 注意：
exec_module会执行模块顶层代码，确保插件文件里没有副作用语句（如直接发 HTTP 请求）
插件实例化必须隔离命名空间和异常传播
一个插件 initialize 报错，不该让整个插件管理器瘫痪。也不能让插件里的全局变量（比如缓存字典、单例连接）污染其他插件。
关键控制点：
- 每个插件实例应在独立作用域中创建，避免共用
globals()；可考虑用types.SimpleNamespace封装配置上下文传入 - 加载时用
try/except包住整个实例化过程，记录失败插件名和错误信息，继续加载下一个，而不是raise中断 - 禁止插件在
__init__里做重操作（如连数据库），所有初始化逻辑收归initialize()，由宿主统一调度时机
最易被忽略的是日志上下文隔离——不同插件打的日志应该带插件名前缀，否则线上出问题时根本分不清是哪个插件卡死或循环打印。这不属于架构层强制项，但没做等于没完成插件化。
