__init_subclass__ 比元类更适合插件注册，因其简洁、无冲突、支持参数化注册且规避循环导入；注册表应基于 dict 实现存查清操作，并在注册时强制校验接口契约。
为什么 __init_subclass__ 比元类更适合插件注册
直接写元类容易过度设计——多数插件注册场景只需要在类定义完成时触发一次逻辑，而 __init_subclass__ 天然满足这个需求，且无须继承、无须重写 __new__，可读性和调试成本都更低。真实项目中，90% 的“自动注册”需求用它就能闭环。
常见错误现象：TypeError: metaclass conflict，尤其当插件基类还要继承 ABC 或 pydantic.BaseModel 时，元类冲突几乎不可避免；而 __init_subclass__ 是普通方法，不参与 MRO 构建，完全规避该问题。
- 所有子类定义后立即执行，等价于“静态注册钩子”
- 支持接收关键字参数（如
plugin_name="auth"），便于声明式配置 - 注册表建议用
dict而非list，避免重复注册或覆盖：检查cls.__name__或显式name字段是否已存在
如何安全地在 __init_subclass__ 中注册并避免循环导入
插件模块常分散在不同文件，import 顺序稍有不慎就会触发循环依赖。关键不是“怎么导入”，而是“什么时候注册”——注册动作必须延迟到模块真正加载完毕之后，而非类解析中途。
典型错误：在 plugins/auth.py 里 import core.plugin_registry，又在 core/plugin_registry.py 里提前 import plugins.auth —— 这时 __init_subclass__ 尚未触发，但导入已卡死。
立即学习“Python免费学习笔记（深入）”；
- 注册逻辑只放基类中，插件模块只负责定义类，不主动调用任何注册函数
- 确保插件模块不被
core层反向 import；推荐用字符串路径（如"plugins.auth.JWTAuthPlugin"）延迟加载，实际使用时再importlib.import_module - 注册表本身应定义在独立模块（如
registry.py），且不 import 任何插件模块
plugin_registry 需要支持哪些基础操作
注册不是终点，后续要按名取实例、校验接口一致性、支持热重载。一个最小可用的注册表至少得提供三件事：存、查、清。
性能影响：若插件数量超百，用 dict.get(name) 查找是 O(1)，比遍历 list 快一个数量级；但若需按标签（如 type="filter"）批量筛选，就得额外维护反向索引。
-
register(cls, name=None)：默认用cls.__name__，允许显式传入name避免命名冲突 -
get(name)：返回类本身（非实例），实例化由业务代码控制，利于解耦生命周期 -
clear()：测试时必需，否则 pytest 多个 test 模块会互相污染注册表
# registry.py
_plugins = {}
<p>def register(cls, name=None):
name = name or cls.<strong>name</strong>
if name in _plugins:
raise ValueError(f"Plugin {name} already registered")
_plugins[name] = cls</p><p>def get(name):
return _plugins.get(name)</p><p>def clear():
_plugins.clear()</p>如何验证插件是否符合微服务契约
注册不等于可用。微服务插件通常要实现约定的方法（如 handle_request）、携带必要元数据（如 version、required_env），这些不能靠文档约束，得在注册时强制校验。
容易被忽略的点：Python 类型注解在运行时不生效，isinstance(obj, Protocol) 也仅对实例有效——所以校验必须基于方法签名和属性存在性，而非类型。
- 检查
hasattr(cls, "handle_request") and callable(getattr(cls, "handle_request")) - 要求类定义
__metadata__字典或类属性（如cls.version），缺失则拒绝注册 - 可选：用
inspect.signature校验handle_request参数是否含context: dict，防止后期调用崩掉
注册逻辑看似简单，但跨模块、跨环境、跨版本时，真正难的是让注册行为稳定可预测——不是“能不能注册”，而是“什么时候注册、谁有权注册、注册失败时有没有明确出口”。这些细节不写进代码，光靠文档没人会看。
