本文详解如何在使用 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]);? 关键说明：
-
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 驱动支持）。
总结：永远不要用字符串拼接构造 IN 列表；优先采用 JSON_TABLE 实现类型安全、参数化、可扩展的数组查询。这不仅解决 BIGINT 精度问题，更是构建健壮数据库交互的标准实践。
