本文介绍在 MySQL 8.0+ 环境下，使用 JSON_OVERLAPS() 函数高效判断表中逗号分隔的 trueIDs 字段是否与 PHP 传入的用户授权 ID 集合存在交集，避免循环查询或低效字符串匹配。
本文介绍在 mysql 8.0+ 环境下，使用 `json_overlaps()` 函数高效判断表中逗号分隔的 `trueids` 字段是否与 php 传入的用户授权 id 集合存在交集，避免循环查询或低效字符串匹配。
在实际业务中，常遇到类似场景：数据库某字段（如 trueIDs）以逗号分隔字符串形式存储一组数字 ID（如 '92,28,1'），而应用层（如 PHP）持有一个较大的用户可访问 ID 列表（如 [925, 28, 1, 99, ...]）。目标是快速筛选出 trueIDs 中至少有一个 ID 属于用户授权列表的所有发票记录（InvoiceId）。
传统做法（如 FIND_IN_SET() 嵌套、LIKE 模糊匹配或 PHP 层循环查询）存在严重性能缺陷：前者无法利用索引、易因边界问题误判（如匹配到 1 时错误命中 11 或 21）；后者则产生 N+1 查询，随用户权限规模扩大而急剧退化。
MySQL 8.0 引入的 JSON_OVERLAPS() 函数为此类集合交集判断提供了原生、安全且高性能的解决方案。其核心思路是将两个逗号分隔字符串统一转换为 JSON 数组，再通过标准 JSON 集合运算判断是否存在公共元素。
✅ 正确用法如下：
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录，或需要将该能力封装成可公开复用的 Codex skill。
SET @UserAllowed = '925,28,1,99,1059,314,422,96,917,356';
SELECT InvoiceId
FROM Invoices
WHERE JSON_OVERLAPS(
CONCAT('[', @UserAllowed, ']'),
CONCAT('[', trueIDs, ']')
);该语句将 '925,28,1,...' 和 '92,28,1' 分别构造成 JSON 数组 [925,28,1,...] 与 [92,28,1]，JSON_OVERLAPS() 自动执行去重、类型校验与集合交集检测——只要任一数字相同即返回 TRUE，无需担心前导零、空格或顺序问题。
⚠️ 使用前提与注意事项：
- MySQL 版本要求：必须为 8.0.17 或更高版本（JSON_OVERLAPS 在此版本引入）；
- 数据格式保障：trueIDs 字段值必须为纯数字逗号分隔（不含空格、引号或非数字字符），否则 CONCAT('[', ..., ']') 生成的 JSON 将非法，导致查询失败；
- 性能优势：相比正则或循环匹配，该方案由 C++ 实现的 JSON 引擎直接处理，时间复杂度接近 O(M+N)，且可配合覆盖索引进一步优化（虽 trueIDs 本身难索引，但可考虑冗余 JSON 列并建 GENERATED COLUMN + INDEX）；
- PHP 安全传参：切勿拼接用户输入！应通过预处理参数绑定 @UserAllowed，或在 PHP 中验证并过滤 $_POST['allowed_ids'] 后再构造安全字符串。
? 进阶建议：若该查询高频执行，推荐重构数据模型——将 trueIDs 拆分为关联表（invoice_ids），通过 JOIN + IN 或 EXISTS 实现真正意义上的集合关系查询，兼顾规范性与极致性能。但在无法修改表结构的遗留系统中，JSON_OVERLAPS 是当前最简洁、可靠且高效的替代方案。
