下界通配符（? super T）是解决分布式文件系统多版本元数据注册与回调兼容性的关键契约设计，允许旧版处理器安全接入新版分片事件流，无需修改代码；注册接口应声明为 void registerHandler(? super UploadEvent handler)，支持传入UploadEvent及其父类，避免使用? extends；事件分发仍按原始类型触发，运行时多态保障兼容性；字段语义漂移通过轻量适配和schema版本号透传处理；禁止在接口中新增非可选方法以遵守Liskov替换原则；事件总线借此支持异构节点混跑与灰度迁移。
下界通配符（? super T）在分布式文件系统分片上传逻辑中，不是用来“泛化数据类型”的装饰语法，而是解决多版本元数据注册与回调兼容性的关键契约设计。核心在于：让旧版元数据处理器能安全接入新版分片事件流，无需修改代码、不破坏现有调用链。
分片上传事件监听器的注册接口必须用 ? super UploadEvent
传统写法如 void registerHandler(UploadV2Handler handler) 会把监听器锁定在特定版本，导致 V1 元数据服务无法响应 V2 分片事件。正确方式是将注册入口改为消费语义明确的下界声明：
-
void registerHandler(? super UploadEvent handler)—— 允许传入UploadEvent、其父类FileOperationEvent，甚至通用基类StorageEvent - V1 元数据服务若实现的是
StorageEvent接口，可直接注册；V2 新增的UploadV2Event extends UploadEvent也能被同一处理器捕获 - 避免使用
? extends UploadEvent，那会使注册接口变成“只读集合”，无法用于事件分发回调
元数据存储层保持原始类型调用，保障运行时多态
下界通配符只作用于注册边界，不改变内部执行逻辑。所有事件分发仍按原始抽象类型触发：
- 分片上传完成时，系统以
UploadEvent类型统一调用onPartUploaded()方法 - 若某处理器是
LegacyMetadataHandler extends StorageEvent，只要它重写了兼容的事件方法，JVM 自然按实际类型分派，无需反射或强制转型 - 元数据写入模块（如 Etcd 或 Raft-based MetadataStore）仍接收强类型的
UploadEvent实例，确保序列化、校验、幂等性控制不退化
跨版本元数据字段映射需配合契约升级策略
向下兼容不只是类型接入，更要处理字段语义漂移。例如 V2 新增 chunkHashList 字段，而 V1 处理器未定义该字段：
- 在事件构造阶段做轻量适配：V2 事件对象内部自动填充默认值或降级为
null，保证 V1 处理器不会因 NPE 崩溃 - 元数据 Schema 版本号（如
schemaVersion: "1.2"）随事件透传，处理器可选择性忽略未知字段，而非拒绝解析 - 禁止在
? super UploadEvent接口里新增非可选方法——那会违反 Liskov 替换原则，破坏兼容性根基
分布式场景下的事件总线延伸：支持异构节点混跑
当不同集群节点运行不同版本的元数据服务（如部分节点还在用 V1 SDK，部分已升级 V2），下界通配符让总线层具备“柔性接纳”能力：
- 总线分发方法声明为
dispatch(? super UploadV2Event event)，则 V1 的GenericStorageEventHandler<storageevent></storageevent>可正常订阅 - 无需为每个版本单独维护 Topic 或 Channel，降低运维复杂度
- 配合事件版本路由策略（如按
event.version 转发至 legacy-group），可实现灰度迁移
