Angular执行ng serve报TS2339:then不存在于false类型错误

这个TS2339是TypeScript静态类型检查抛出的错误，核心问题是getVideoMediaData()方法的返回值类型不统一：

• 入参file为undefined时，方法直接返回布尔值false
• 入参合法时，方法返回Promise实例

TypeScript会自动推导该方法的返回类型为false | Promise<unknown>，调用时直接链式调用.then()，TS会校验所有可能的返回值是否存在then属性——布尔值false是原始类型，本身没有then方法，因此触发类型报错。
之所以应用还能正常编译访问，是因为Angular开发模式下对TS类型错误做了容错，不会阻断构建流程，仅在终端打印错误；只要运行时没走到返回false的分支，代码就能正常执行，但类型校验始终不通过。

统一方法的返回类型，所有分支都返回Promise实例，从根源消除类型联合问题，不要用返回布尔值的方式做分支兜底。
修改后的方法代码如下：

// 显式标注返回类型，从语法层面约束返回值统一
public getVideoMediaData(file): Promise<unknown> {
    if (typeof file === 'undefined') {
        // 原返回false的分支改为返回立即完成的Promise，和正常分支类型保持一致
        return Promise.resolve(false);
    }

    return new Promise((resolve, reject) => {
        this.postingService.getMetadata(file.url).subscribe(
            data => {
                resolve(data);
                const errors = data.errors;
                file.errors = [];
                if (errors && errors.length > 0 ) {
                    errors.forEach(function(ffmpegError) {
                        file.errors.push({
                            'message': ffmpegError,
                            'validation': 'ffmpeg'
                        });
                    }, this);
                }
            },
            errorResponse => {
                reject(errorResponse);
            }
        );
    });
}

修改后方法返回值固定为Promise类型，所有返回值都自带then方法，TS类型检查会直接通过，终端不再抛出该错误。如果有明确的接口返回结构，还可以给Promise指定更精确的泛型类型，进一步提升类型安全性。

不推荐的临时处理方式 #

• 调用位置加类型断言强制将返回值标注为Promise：比如写成(this.getVideoMediaData(file) as Promise<unknown>).then(...)，这种写法只是骗过了TS检查，一旦运行时走到返回false的分支，会直接抛出.then is not a function的运行时错误，没有解决根本问题。
• 关闭TypeScript严格类型检查：会大幅降低TS的类型防护能力，提升后续出bug的概率，不建议使用。

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