Express中使用mysql2实现动态条件查询的问题

问题场景 #

在Express框架中使用mysql2进行数据库操作，现有查询方法如下：

static fetchAll(idClass, groupeNumber, adminCreator) {
    return db.execute(
        "SELECT * FROM cohorts WHERE (idClass = ?) AND (groupeNumber = ?  ) AND (adminCreator = ? )",
        [idClass,groupeNumber, adminCreator]
    );
}

需求是：

• 仅传入idClass时，返回符合该idClass的结果
• 仅传入groupeNumber时，返回符合该groupeNumber的结果

尝试将未传入的参数设为null，但无法得到预期结果，需要解决方法。

解决方案 #

核心思路是动态构建SQL查询条件，只加入有值的参数作为过滤条件，避免null导致的匹配问题。

方法一：手动构建条件和参数数组 #

static fetchAll(idClass, groupeNumber, adminCreator) {
    let conditions = [];
    let params = [];

    // 逐个判断参数是否存在，构建条件
    if (idClass !== undefined && idClass !== null) {
        conditions.push("idClass = ?");
        params.push(idClass);
    }
    if (groupeNumber !== undefined && groupeNumber !== null) {
        conditions.push("groupeNumber = ?");
        params.push(groupeNumber);
    }
    if (adminCreator !== undefined && adminCreator !== null) {
        conditions.push("adminCreator = ?");
        params.push(adminCreator);
    }

    // 拼接SQL语句
    let sql = "SELECT * FROM cohorts";
    if (conditions.length > 0) {
        sql += " WHERE " + conditions.join(" AND ");
    }

    return db.execute(sql, params);
}

这种方式灵活可控，只会加入有实际值的过滤条件，完全避免null带来的匹配错误。

方法二：使用SQL的条件判断（兼容参数为null的情况） #

如果不想动态拼接SQL，可以修改WHERE条件，让参数为null时该条件自动失效：

static fetchAll(idClass, groupeNumber, adminCreator) {
    return db.execute(
        `SELECT * FROM cohorts 
         WHERE (idClass = ? OR ? IS NULL) 
           AND (groupeNumber = ? OR ? IS NULL) 
           AND (adminCreator = ? OR ? IS NULL)`,
        [idClass, idClass, groupeNumber, groupeNumber, adminCreator, adminCreator]
    );
}

这里每个参数都传两次：第一次用于匹配，第二次判断是否为null。如果参数是null，OR ? IS NULL就会成立，相当于跳过该条件。

注意：如果你的参数可能是空字符串，需要额外判断，比如改成(idClass = ? OR ? IS NULL OR ? = '')。

说明 #

第一种动态拼接的方式更高效，因为只会生成必要的条件；第二种方式代码更简洁，但会生成包含所有条件的SQL，数据库优化器需要处理更多判断。根据实际场景选择即可。

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