TypeScript接口属性全可选时为何无法校验传入对象的多余属性

这是TypeScript的**多余属性检查（也叫新鲜度检查）**的生效规则差异导致的，TS针对对象类型的校验严格度会随场景变化：

• 如果对象字面量直接写在目标类型位置（比如直接作为函数入参、直接赋值给显式标注了类型的变量），就会触发严格的多余属性检查，只要出现目标类型没声明的属性，直接抛类型错误
• 如果先把对象赋值给没有显式类型标注的变量，再把变量传到目标类型位置，TS只会走常规的结构兼容性校验：只要传入值包含目标类型要求的所有必填属性、已有的属性类型匹配，就算带额外属性也会判定为类型兼容，不会报多余属性的错。

对应代码场景的具体说明 #

不报错的场景 #

你定义query变量时没有显式标注类型，TS会自动给它推导类型为{ pag: number; limit: number; }。当你把这个变量传给req函数的params参数时，走的是常规结构校验：

1. 目标类型Params里的两个属性都是可选的，没有必填属性要求
2. query里的limit是number类型，和Params里定义的limit类型完全匹配
3. 额外的pag属性属于变量传参场景，不会触发多余属性检查，所以最终校验通过，不会报错。

显式标注Params类型时报错的场景 #

当你给query显式标注类型为Params时，相当于把右侧的对象字面量直接赋值给Params类型的目标位置，会触发多余属性检查：对象里存在Params没声明的pag属性，自然就抛出类型错误了。

同理，如果你直接写内联传参req({ params: { pag: 2, limit: 10 } })，也会因为对象字面量直接写在参数位触发多余属性检查，一样会报错。

强制校验额外属性的方法 #

如果你希望不管是内联传参还是先存变量再传参，只要params里带Params未定义的属性就报错，可以给接口加索引签名做反向约束：

interface Params {
  page?: number;
  limit?: number;
  // 禁止所有未提前声明的属性
  [key: string]: never;
}

加完这个约束后，只要传入的params带额外属性，不管用什么传参方式都会触发类型错误。

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