Node.js(TypeScript)如何将MySQL查询结果映射到指定模型？

问题根源 #

TypeScript的接口是编译时类型约束，不会在运行时自动过滤对象的属性；再加上你用了SELECT *查询，数据库会返回表中所有字段，所以最终返回的对象自然包含所有列，和你定义的User接口无关。

具体解决方案 #

1. 最推荐：SQL查询时指定需要的字段

直接修改SQL语句，只查询id和name两个字段，这样数据库返回的结果本身就只有这两个属性，完全符合你的模型定义，同时还能提升查询性能：

export class UserService {
  async getUserById(id: string) {
    // 只查询需要的字段，而非SELECT *
    const [data] = await connection.query<User[]>("SELECT id, name FROM user WHERE id = ?", [id]);
    return data[0];
  }
}

2. 手动映射属性（适合需要保留全量查询但返回指定字段的场景）

如果因为某些原因必须查询全量字段，但只想返回模型定义的属性，可以手动构造新对象：

export class UserService {
  async getUserById(id: string) {
    const [data] = await connection.query<User[]>("SELECT * FROM user WHERE id = ?", [id]);
    const user = data[0];
    // 只提取需要的属性构造新对象
    return {
      id: user.id,
      name: user.name
    } as User;
  }
}

3. 封装通用映射函数（适合多个模型复用的场景）

如果有多个模型需要做类似的属性映射，可以封装一个通用函数来提取指定属性：

// 通用映射函数
function mapToModel<T>(source: any, allowedKeys: (keyof T)[]): T {
  const result = {} as T;
  allowedKeys.forEach(key => {
    if (source.hasOwnProperty(key)) {
      result[key] = source[key];
    }
  });
  return result;
}

// 在UserService中使用
export class UserService {
  async getUserById(id: string) {
    const [data] = await connection.query<User[]>("SELECT * FROM user WHERE id = ?", [id]);
    // 传入需要保留的属性数组
    return mapToModel<User>(data[0], ['id', 'name']);
  }
}

注意事项 #

不要依赖TypeScript的类型断言（as User）来过滤属性——它只是告诉编译器“这个对象符合User类型”，不会在运行时对对象做任何修改，所以运行时对象仍然会包含所有数据库返回的字段。

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