症状
编译器报 TS2769，没有与此调用匹配的重载，并列出尝试过的签名。该失败说明提供的实参不满足其中任何一个，常见原因是对象字面量多出属性、回调参数类型与预期不同，或库升级后签名改变。
诊断
逐个比对错误列出的重载；用最小调用法减少实参以定位问题参数；核对已安装库的类型版本。
npx tsc --noEmit --pretty false根因
没有任何重载签名接受所提供的实参类型，原因是类型不匹配、对象字面量多出属性，或库类型定义发生了变化。
修复
让实参符合目标重载：修正类型、移除多余属性、补齐该重载所需选项；库签名变化时更新调用点而非强制转换。
验证
重新运行类型检查确认调用通过，再跑覆盖该调用的测试确认运行时行为不变。类型通过且行为正确即证明实参已匹配目标重载。
常见陷阱
用 as unknown as T 强行绕过会在运行时隐藏参数错误；应让实参真正匹配签名。