TypeScript中为何Record<string, unknown>类型无法兼容含确定键的对象参数？函数类型赋值报错问题

这是个很典型的TypeScript类型兼容性问题，咱们一步步拆解清楚：

为啥会报错？ #

你定义的Props里的onSubmit要求是一个能接受任意Record<string, unknown>对象的函数——意思是，这个函数得能处理任何键是string、值是unknown的对象，哪怕这个对象里没有email和password。

但你要传入的SignIn函数只认更具体的{email: string, password: string}类型，它只能处理有这两个字段的对象。TypeScript之所以报错，是为了保证类型安全：如果允许把SignIn赋值给onSubmit，那当调用onSubmit的时候，万一传入一个没有email/password的对象，SignIn函数运行时肯定要出问题。

为啥有些情况能正常运行？ #

这涉及到TypeScript函数参数的**逆变（contravariance）**规则：如果类型A是类型B的子类型，那么(b: B) => void是(a: A) => void的子类型。举个例子，如果Props的onSubmit是(data: {email: string, password: string}) => void，那你传入一个接受Record<string, unknown>的函数是没问题的——因为宽泛的函数能处理更具体的参数，反过来就不行，也就是你遇到的情况。

解决方案 #

根据你的实际需求，有几个可行的方案：

方案1：用泛型让Props支持具体类型 #

这是最安全也最推荐的方式，让Props根据实际传入的函数参数类型动态调整：

// 定义带泛型的Props
type Props<T> = { onSubmit: (data: T) => void };

// 定义你的登录数据类型和函数
type SignInData = { email: string; password: string };
type SignIn = (data: SignInData) => void;

const signIn: SignIn = (data) => {
  // 处理登录逻辑
  console.log(data.email, data.password);
};

// 使用时指定具体的泛型参数
const props: Props<SignInData> = { onSubmit: signIn }; // 完全正常，没有报错

方案2：调整SignIn函数兼容宽泛参数 #

如果你确实需要Props的onSubmit接受任意对象，那可以让SignIn先做类型检查，确保参数符合要求：

type Props = { onSubmit: (data: Record<string, unknown>) => void };

// 调整SignIn函数，先验证参数结构
const signIn = (data: Record<string, unknown>) => {
  // 类型守卫：确保data有email和password字段，且类型正确
  if ('email' in data && typeof data.email === 'string' && 'password' in data && typeof data.password === 'string') {
    // 这里TypeScript会自动推断data的类型为{email: string, password: string}
    console.log(data.email, data.password);
  } else {
    // 处理参数不符合要求的情况
    throw new Error('Invalid sign-in data');
  }
};

const props: Props = { onSubmit: signIn }; // 现在可以正常赋值

方案3：类型断言（不推荐，仅在确定安全时使用） #

如果你能保证Props的onSubmit永远只会传入符合SignIn要求的参数，可以用类型断言跳过检查，但这会失去TypeScript的类型安全保障：

type Props = { onSubmit: (data: Record<string, unknown>) => void };
type SignIn = (data: {email: string, password: string}) => void;

const signIn: SignIn = (data) => { /* ... */ };

// 用类型断言强制转换
const props: Props = { onSubmit: signIn as (data: Record<string, unknown>) => void };

总结 #

核心要记住：TypeScript对函数参数的类型检查是逆变的，目的是避免运行时因参数不匹配导致的错误。优先用泛型方案，既能保证类型安全，又能灵活支持各种具体的函数参数类型。

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