TypeScript TS2345错误：{a:number}无法赋值给Record<string,unknown>

问题本质 #

这个错误的核心是createPipeline初始化时的上下文类型被固定为Record<string, unknown>，但你的中间件需要上下文包含{a: number}的结构——TypeScript严格的类型检查不允许将要求更具体上下文的中间件赋值给接受宽泛上下文的类型，因为Record<string, unknown>无法保证存在必需的a属性。

解决方案 #

• 让createPipeline支持泛型上下文初始化
  修改createPipeline的定义，允许在创建时指定初始上下文类型，而不是默认用Record<string, unknown>：

  // 调整createPipeline的泛型定义
  function createPipeline<Ctx extends object = Record<string, unknown>, Events = never>(initialCtx?: Ctx) {
    // 内部维护的上下文类型跟随泛型Ctx
    let pipelineContext: Ctx = initialCtx ?? ({} as Ctx);
    
    return {
      use<NewCtx extends object>(middleware: MiddleWare<Ctx, NewCtx, Events>) {
        // 更新上下文类型，合并原有Ctx和NewCtx
        pipelineContext = middleware.process(pipelineContext) as Ctx & NewCtx;
        return this as typeof this & { use: <NextCtx extends object>(mw: MiddleWare<Ctx & NewCtx, NextCtx, Events>) => void };
      },
      execute() {
        return pipelineContext;
      }
    };
  }
  

• 显式指定初始上下文类型创建Pipeline
  当你需要使用依赖{a: number}的中间件时，创建Pipeline时明确指定初始上下文包含a属性：

  // 创建时指定初始上下文类型为{a: number}
  const pipeline = createPipeline<{a: number, x?: number}, TestEvents>({a: 10});
  
  // 此时use可以接受MiddleWare<{a: number}, {x: number}, TestEvents>类型的中间件
  pipeline.use(myMiddleware);
  

• 调整MiddleWare类型的泛型约束
  如果MiddleWare的定义允许上下文的扩展，确保process方法的输入上下文是输出上下文的子集：

  type MiddleWare<InCtx extends object, OutCtx extends InCtx, Events> = {
    process(ctx: InCtx): OutCtx;
    // 其他属性...
  };
  

  这样TypeScript能明确中间件是在原有上下文基础上扩展，而不是要求一个完全不相关的上下文结构。

关键注意点 #

• 避免用unknown或never作为初始上下文类型，除非你确实需要从无到有构建上下文——更合理的方式是从明确的初始上下文开始，逐步扩展。
• 利用TypeScript的泛型类型推断和合并，让Pipeline的上下文类型随着中间件的添加自动累加，而不是固定为宽泛的Record<string, unknown>。

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