在TypeScript中获取MySQL2查询结果数组长度的问题

报错原因 #

你遇到的Property 'length' does not exist on type 'QueryResult'是因为db.execute的返回值是联合类型：执行查询语句时返回结果数组，执行插入/更新等语句时返回OkPacket。TypeScript无法确定当前执行的是查询语句，所以不允许直接访问length属性。

解决方案 #

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

直接断言返回结果为查询数组类型，让TypeScript明确知道devices是数组：

const findLoggedInDevices =
    "SELECT lg.device_id, u.username FROM log_history as lg INNER JOIN users as u on u.id = lg.uid WHERE is_logged_in = 1 AND u.id = ?";
// 断言为查询结果数组 + 元数据的格式
const [devices] = await db.execute(findLoggedInDevices, [data.uid]) as [Record<string, any>[], any];
const numberOfDevicesFound = devices.length;

如果有自定义实体类型，还可以替换Record<string, any>为你的类型（比如LoggedInDevice[]），进一步提升类型安全性。

2. 类型守卫（更安全） #

通过运行时判断确认devices是数组，避免类型断言的潜在风险：

const [devices] = await db.execute(findLoggedInDevices, [data.uid]);
let numberOfDevicesFound = 0;
if (Array.isArray(devices)) {
  numberOfDevicesFound = devices.length;
}

3. 单独统计查询（性能优化） #

如果业务仅需要设备数量、不需要获取具体设备记录，单独编写统计查询会更高效——数据库只返回计数，大幅减少数据传输量：

const countLoggedInDevices = 
    "SELECT COUNT(*) as device_count FROM log_history as lg INNER JOIN users as u on u.id = lg.uid WHERE is_logged_in = 1 AND u.id = ?";
const [countResult] = await db.execute(countLoggedInDevices, [data.uid]) as [{ device_count: number }[], any];
const numberOfDevicesFound = countResult[0].device_count;

选择建议 #

• 如果后续需要使用查询到的设备数据（比如遍历展示、操作设备信息），用类型断言或类型守卫即可，无需额外查询；
• 如果仅需数量，优先用单独统计查询，性能更优。

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