TypeScript TS2322错误：pgUri.password()赋值时类型不兼容问题

问题原因 #

1. @types/urijs类型定义歧义：password()方法的重载定义存在模糊性——无参调用本应返回string，但类型定义和带参链式调用的重载混淆，导致TS错误推断返回值为联合类型。
2. TypeOrm属性类型反向影响：TypeOrm的password属性在部分配置场景下支持函数/Promise函数类型，TS类型检查时错误地将左侧属性的潜在类型关联到右侧，引发pgUri.password()的返回值类型推断偏差。

解决方案 #

1. 显式类型断言（快速解决）

直接强制指定返回值类型为string：

password: pgUri.password() as string

2. 明确变量类型

先将结果存入类型明确的变量，再赋值：

const dbPassword: string = pgUri.password();
// 后续配置
password: dbPassword

3. 修正类型定义（彻底解决）

找到@types/urijs中URI接口的password方法定义，确保无参重载的返回值严格为string：

interface URI {
  // ...其他定义
  password(): string;
  password(newPassword: string): URI;
}

注意：升级@types/urijs时需重新检查该定义。

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