如何在 MySQL 中安全高效地查询包含指定 BIGINT 数组的记录-js教程-PHP中文网

如何在 MySQL 中安全高效地查询包含指定 BIGINT 数组的记录

本文详解如何在使用 serverless-mysql（或类似参数化查询驱动）时，正确传递 BIGINT 类型数组进行 IN 查询，避免因类型截断、字符串拼接或占位符限制导致查不到数据的问题。

本文详解如何在使用 `serverless-mysql`（或类似参数化查询驱动）时，正确传递 bigint 类型数组进行 `in` 查询，避免因类型截断、字符串拼接或占位符限制导致查不到数据的问题。

在 Node.js + TypeScript 环境中使用 serverless-mysql 执行参数化查询时，一个常见误区是试图用单个占位符 ? 代替整个 IN 列表（如 WHERE id IN (?)），并传入一个拼接后的字符串（如 [ids.join()]）。这是无效的：MySQL 的 ? 占位符仅对应单个标量值，无法展开为多个独立参数；而将数组 .join() 成字符串后传入，会导致 MySQL 将其视为单一字符串字面量（例如 '222...,333...,444...'），而非多个数值，从而匹配失败——尤其当字段为 BIGINT 时，类型不匹配还会引发隐式转换或精度丢失。

直接拼接 SQL 字符串（如 IN (222..., 333..., 444...)）虽在 phpMyAdmin 中可行，但在生产代码中极其危险，易引发 SQL 注入，且 BigInt 在 JavaScript 中无法被 JSON 序列化，JSON.stringify(BigInt) 会抛出错误，进一步增加风险。

✅ 推荐方案：使用 MySQL 8.0+ 的 JSON_TABLE() 函数动态展开 JSON 数组
该方法既保持参数化安全，又完美支持 BIGINT，无需手动拼接 SQL：

const ids: bigint[] = [
  222222222222222222222n,
  3333333333333333333333n,
  444444444444444444444n
];

// 安全序列化 BigInt 数组为 JSON 字符串（注意：需转为 string）
const idsJson = JSON.stringify(ids.map(id => id.toString()));

const query = `
  SELECT servers.* 
  FROM servers
  JOIN JSON_TABLE(?, '$[*]' COLUMNS (id BIGINT PATH '$')) AS criteria 
    ON servers.id = criteria.id
`;

const results = await ExcuteQuery(query, [idsJson]);

? 关键说明：

MySQL

编写正确的MySQL查询，避免字符集、索引和锁方面的常见陷阱。

下载

JSON_TABLE(CONCAT('[', ?, ']'), ...) 写法虽见于部分示例，但更简洁安全的方式是直接传入已加方括号的 JSON 字符串（即 '[1,2,3]'），避免在 SQL 中拼接；
COLUMNS (id BIGINT PATH '$') 显式声明解析出的字段类型为 BIGINT，确保与目标表 servers.id 类型严格一致；
JOIN ... ON 比 USING (id) 更清晰可控，且兼容所有 MySQL 版本行为。

⚠️ 注意事项：

此方案要求 MySQL ≥ 8.0.4（JSON_TABLE 引入版本）；若使用旧版 MySQL，需改用服务端动态生成占位符（如 WHERE id IN (?, ?, ?)），并确保 values 数组长度与占位符数量严格匹配；
JavaScript 中 BigInt 字面量必须带 n 后缀（如 123n），且不能参与 JSON.stringify 直接序列化——务必先 .map(id => id.toString())；
serverless-mysql 默认不支持 bigint 类型返回（会转为字符串），若需原始 BigInt，请启用 supportBigNumbers: true 和 bigNumberStrings: false 配置（需底层 MySQL 驱动支持）。