构建高性能中间件系统需契约先行：模块须具名导出含 name、setup（异步初始化）、teardown（可选清理）的标准对象，禁用默认导出与顶层副作用；结合动态 import() 实现运行时按需加载与代码分割；通过 typescript 类型定义（如 middleware 接口）和 definemiddleware 工具保障签名安全与 ide 提示；所有副作用严格收敛于 setup/teardown 内。
要构建支持“异步逻辑注入”的高性能中间件模块系统，关键不是堆砌 export 语句，而是用 export 精确声明可被框架按需加载、生命周期可控、类型安全且无隐式副作用的中间件单元。核心在于契约先行、导出即契约——每个模块对外暴露的必须是明确签名的异步函数或配置对象，而非裸逻辑。
定义统一的中间件导出接口
所有中间件模块必须导出一个标准命名对象（禁止 export default），包含 name、setup 和可选的 teardown 字段：
-
name是字符串唯一标识，用于日志、调试和插件管理 -
setup是返回Promise的函数，接收上下文（如app、config、hooks），负责注册路由、监听事件、初始化连接等异步操作 -
teardown是可选的清理函数，也返回Promise，确保中间件可卸载 - 所有导出内容必须为纯声明，不执行任何副作用（例如不能在顶层写
fetch()或setTimeout()）
用具名导出 + 动态 import() 实现运行时注入
静态 import 会强制打包进主包，失去“注入”灵活性。必须结合 import() 表达式，在运行时根据配置或条件加载：
- 路径由策略决定，例如：
const mod = await import(`./middleware/${id}.js`) - 解构时严格依赖具名导出：
const { setup, name } = mod，避免因默认导出导致类型模糊或命名冲突 - 构建工具（Vite/Webpack）自动将每个
import()转为独立 chunk，实现真正的代码分割与懒加载 - 支持按环境/角色/租户动态选择中间件，比如：
import(`./middleware/auth-${env}.js`)
同步导出 TypeScript 类型保障注入安全
仅靠 JS 导出无法约束中间件质量。每个模块应同时导出类型定义：
- 定义
MiddleWare接口，并export type { MiddleWare } - 在框架主模块中使用
import type引入该类型，校验setup参数签名（如是否接收app: App）和返回值（是否为Promise<void></void>） - 配合
defineMiddleware工具函数封装导出逻辑，让开发者获得 IDE 自动补全与编译期报错提示 - 类型不参与运行时，零成本，但极大降低误用概率
收敛副作用到 setup/teardown 内部
高性能中间件系统要求“可注入、可卸载、可重试”。这就要求所有副作用必须显式收口：
- 不允许导出带副作用的常量（如已初始化的
axios实例、已绑定的EventEmitter） - 所有异步初始化逻辑（数据库连接、WebSocket 建立、定时器启动）必须包裹在
setup函数体内 - 所有资源释放逻辑（关闭连接、清除监听、取消定时器）必须写在
teardown中，且能被框架统一调用 - 导出的
config或schema应为纯 JSON 可序列化数据，不含函数或闭包
