TypeScript接口定义string类型，为何允许赋值数字类型user_id？

问题场景 #

定义的接口如下：

export default interface IPost {
  id: number;
  title: string;
  content: string;
  imageUrl: string;
  user_id: string;
}

通过Fetch加载数据的代码：

.then((data: IPost[]) => {
  console.log("POST DATA", data);
  const posts = data.map((p: IPost) => {
    const post: IPost = {
      id: p.id,
      title: p.title,
      content: p.content,
      imageUrl: p.imageUrl,
      user_id: p.user_id // 接口定义为string，但实际数据是number
      // 临时修复：改为user_id: p.user_id.toString()
    }
    console.log('post map', post, typeof post.user_id)
    return post
  })
})

运行时发现user_id实际是number类型，虽然接口要求是string，但TypeScript编译阶段没有报错，只有运行时通过typeof才发现类型不符。

原因解析 #

TypeScript是静态类型检查工具，它的类型校验只在编译阶段进行，不会介入运行时的类型验证。

你这里给data标注IPost[]类型，本质是类型断言——相当于告诉TypeScript“我确认这个数据完全符合IPost数组的结构”，但TS不会真的去校验返回的JSON数据是否和接口定义一致。后端返回的JSON里user_id是number，解析后依然是number，TS只是“相信”你标注的类型，不会在编译阶段抛出错误，直到运行时才会暴露实际类型和接口定义的矛盾。

解决方案 #

1. 手动转换类型：像你已经做的那样，显式把number转为string：

   user_id: p.user_id.toString()
   

2. 添加运行时类型校验：使用Zod、io-ts这类库，在数据解析后验证结构和类型，确保后端返回的数据完全符合接口定义，不符合时直接抛出错误，避免后续逻辑出问题。
3. 调整接口定义：如果后端确实约定user_id返回number类型，直接修改接口里的user_id为number，让类型定义和实际数据匹配。

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