如何使用MySQL在TypeScript中实现数据类型转换功能

在TypeScript后端项目中，使用MySQL存储数据时，查询结果往往和我们预计的类型不一致。MySQL的驱动通常把数值、时间等字段以特定JavaScript形式返回，如果不在TypeScript中做数据类型转换，就容易出现运行时错误或者类型不匹配。下面我们基于mysql2库，演示如何把MySQL返回的数据转换成清晰的TypeScript类型。

为什么需要数据类型转换

MySQL中的字段类型和JavaScript类型并不是一一对应的。例如：

• TINYINT(1) 常被用来表示布尔值，但驱动可能返回 0 或 1 的数字
• DECIMAL 类型在查询时经常以字符串形式返回，直接参与计算会出错
• DATETIME 默认返回 JavaScript Date 对象，但有些配置下会是字符串

在TypeScript里，如果我们直接用 any 或松散类型，就失去了静态检查的优势。通过显式转换，可以让函数返回类型更准确。

基础转换工具函数

我们可以先写几个简单的转换函数，把未知类型转成目标类型：

// 将可能是字符串或数字的输入转为 number
function toNumber(val: unknown): number {
  if (typeof val === 'number') {
    return val;
  }
  if (typeof val === 'string') {
    const n = Number(val);
    if (isNaN(n)) {
      throw new Error('无法转换为数字: ' + val);
    }
    return n;
  }
  throw new Error('不支持的类型');
}

// 将 TINYINT 转为布尔值
function toBoolean(val: unknown): boolean {
  if (typeof val === 'number') {
    return val !== 0;
  }
  if (typeof val === 'string') {
    return val !== '0' && val !== '';
  }
  return Boolean(val);
}

// 将日期字段统一转为 Date
function toDate(val: unknown): Date {
  if (val instanceof Date) {
    return val;
  }
  if (typeof val === 'string' || typeof val === 'number') {
    const d = new Date(val);
    if (isNaN(d.getTime())) {
      throw new Error('无效日期: ' + val);
    }
    return d;
  }
  throw new Error('不支持的日期类型');
}

在查询层中应用转换

使用 mysql2/promise 查询数据后，我们可以在映射阶段调用上面的函数：

import mysql from 'mysql2/promise';

interface UserRow {
  id: number;
  name: string;
  is_active: boolean;
  created_at: Date;
  balance: number;
}

async function getUserById(conn: mysql.Connection, uid: number): Promise<UserRow> {
  const [rows] = await conn.query('SELECT id, name, is_active, created_at, balance FROM user WHERE id = ?', [uid]);
  const row = (rows as any[])[0];
  return {
    id: toNumber(row.id),
    name: String(row.name),
    is_active: toBoolean(row.is_active),
    created_at: toDate(row.created_at),
    balance: toNumber(row.balance)
  };
}

使用类型映射表减少重复代码

当表结构变多时，可以用一个映射配置来描述每个字段的转换方式：

type Converter = (v: unknown) => any;

const userConverters: Record<keyof UserRow, Converter> = {
  id: toNumber,
  name: (v) => String(v),
  is_active: toBoolean,
  created_at: toDate,
  balance: toNumber
};

function mapRow<T>(row: Record<string, unknown>, converters: Record<keyof T, Converter>): T {
  const result: any = {};
  for (const key in converters) {
    result[key] = converters[key as keyof T](row[key]);
  }
  return result as T;
}

注意事项

在代码里提到 HTML 标签名称时要转义，比如 <input> 只是说明用途而不是真实标签。另外，函数调用如 toNumber() 不要写成标签形式。实际项目中建议把转换逻辑放在数据访问层，业务层只消费明确的 TypeScript 类型，这样既能利用 MySQL 的存储能力，也能保持前端和后端的类型安全。

MySQLTypeScript数据类型转换修改时间：2026-07-28 13:36:22