如何在Node.js中动态构建带多组OR连接LIKE条件的MySQL查询
动态实现多OR串联LIKE模糊查询的方案(Node.js + MySQL)
核心思路非常简单:把动态变化的条件结构(也就是OR串联的LIKE语句骨架)和实际的匹配值分开处理——结构根据入参数量动态生成,值全部通过参数化占位符传入,既适配不定数量的参数,又完全避免SQL注入风险。
具体实现步骤(以常用的mysql2库为例)
1. 先做入参清洗
先过滤掉前端传的无效参数(空字符串、null、undefined等),避免生成无意义的col LIKE '%%'全匹配条件,同时处理空参数的边界情况:
// 假设前端传的参数数组是req.query.searchTerms const rawSearchValues = req.query.searchTerms || []; // 过滤无效值,转成字符串避免类型问题 const validSearchValues = rawSearchValues .map(item => String(item).trim()) .filter(item => item.length > 0); // 空参数的边界处理,根据业务逻辑自定义返回逻辑即可 if (validSearchValues.length === 0) { return res.status(400).json({ message: '请传入有效的搜索关键词' }); }
2. 动态拼接条件骨架
根据有效参数的数量,生成对应数量的col LIKE ?片段,用OR串联,注意只拼条件结构,不要把实际值写到SQL里:
// 每个参数对应一个独立的LIKE占位符条件,用OR拼接 const likeConditionFragment = validSearchValues .map(() => '`col` LIKE ?') .join(' OR ');
如果后续需要和其他WHERE条件(比如
status = 1这类固定条件)组合,一定要把生成的OR片段用括号包裹,避免MySQL运算优先级导致的逻辑错误:// 示例:和固定条件组合的正确写法 const fullWhereClause = `is_deleted = 0 AND (${likeConditionFragment})`;
3. 组装参数并执行查询
把每个关键词包装成带%的模糊匹配格式,作为参数数组传入查询方法,由MySQL驱动自动做转义处理,完全不需要手动拼值到SQL语句里:
// 组装参数:每个关键词匹配前后的模糊通配符 const queryParams = validSearchValues.map(val => `%${val}%`); // 生成最终SQL const sql = `SELECT * FROM USERS WHERE ${fullWhereClause}`; // 执行参数化查询,mysql2会自动把参数替换到对应占位符位置,防止注入 const [userRows] = await connection.execute(sql, queryParams);
常见踩坑提醒
- 绝对不要直接把关键词值拼到SQL字符串里,类似
`col LIKE '%${val}%'`这种写法会直接暴露SQL注入风险,所有值必须走参数化占位符传入。 - 如果匹配的字段名是MySQL保留字(比如
order、desc这类),一定要用反引号把字段名包裹起来,避免语法报错。 - 如果参数数量特别多(比如超过上百个),要注意MySQL的查询长度限制和执行效率,必要时可以换成全文索引的方案,普通业务场景下上述写法完全够用。
内容的提问来源于stack exchange,提问作者Sabo Boz
相关产品推荐
相关产品推荐

