TypeScript函数重载失效求助：类型不兼容报错

错误原因 #

1. 接口X的重载未覆盖传入convert: false的场景，但实现函数允许该参数为false，导致签名不匹配；
2. 实现函数的返回类型被推断为联合类型，无法分别匹配每个重载的精确返回类型要求。

解决方案 #

方案一：补充接口重载（支持传入false） #

如果业务需要允许传入false参数，给接口X补充对应的重载签名，覆盖所有调用场景：

interface X {
    (str: string): { result: string };
    (str: string, convert: true): { result: number };
    (str: string, convert: false): { result: string }; // 新增重载
}

const func: X = (str, convert = false) => {
    if (convert) {
        return { result: parseInt(str, 10) };
    }
    return { result: str };
};

方案二：严格匹配原接口（仅支持不传参数或传true） #

如果不需要支持传入false，调整实现函数的参数类型，使其严格匹配原接口的重载定义：

interface X {
    (str: string): { result: string };
    (str: string, convert: true): { result: number };
}

const func: X = (str: string, convert?: true) => {
    if (convert) {
        return { result: parseInt(str, 10) };
    }
    return { result: str };
};

说明 #

• 方案一通过补充重载，让接口完整覆盖所有可能的参数组合，TypeScript能自动识别每个分支的返回类型；
• 方案二限制参数类型为true | undefined，严格对齐原接口的两个重载，避免类型不兼容报错。

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