SQLite动态使用IN()子句时多值查询无结果问题排查

我一眼就看出问题出在哪了——你构建SQL查询参数的方式完全错误！

问题分析 #

你现在的代码把所有lstLang里的语言ID拼成了一个字符串res（比如"en,fr,ar"），然后把这个字符串作为单个参数传给query方法。但实际上你构建的IN(?, ?, ?)里的每个问号都需要对应一个独立的参数，SQL会把"en,fr,ar"当成一个完整的字符串去匹配langId字段，而不是拆分成三个单独的值，这就导致多值查询时完全匹配不到数据。

修复步骤 #

核心思路是：每个语言ID对应一个独立的占位符参数，而不是把它们拼接成一个字符串。

1. 保留构建问号列表的逻辑，但不需要拼接语言ID字符串；
2. 直接将lstLang中的每个元素（转小写后）作为独立参数，再加上最后固定的"S300"参数；
3. 可以用StringJoiner替代StringBuilder来简化问号拼接的代码，更简洁易读。

修改后的完整代码 #

public List<ListCoursesFilterModel> getListSubject(List<String> lstLang) {
    // 处理空列表的情况，避免SQL语法错误
    if (lstLang == null || lstLang.isEmpty()) {
        return Collections.emptyList();
    }

    // 用StringJoiner构建IN子句的问号部分
    StringJoiner questionMarkJoiner = new StringJoiner(",");
    for (int i = 0; i < lstLang.size(); i++) {
        questionMarkJoiner.add("?");
    }
    String qs = questionMarkJoiner.toString();

    List<ListCoursesFilterModel> list = new ArrayList<>();
    SQLiteDatabase db = databaseHelper.getWritableDatabase();
    Cursor cursor = null;

    try {
        // 构建参数数组：先放所有转小写的语言ID，再放固定的identifier参数
        String[] params = new String[lstLang.size() + 1];
        for (int i = 0; i < lstLang.size(); i++) {
            params[i] = lstLang.get(i).toLowerCase();
        }
        params[lstLang.size()] = "S300";

        cursor = db.query(
                false,
                "ShortMajorTBL",
                null,
                "langId IN(" + qs + ") AND identifier =?",
                params,
                null,
                null,
                null,
                null
        );

        if (cursor != null && cursor.moveToFirst()) {
            do {
                ListCoursesFilterModel listCoursesFilterModel = new ListCoursesFilterModel();
                listCoursesFilterModel.setSubject(cursor.getString(cursor.getColumnIndex("subject")));
                listCoursesFilterModel.setLangId(cursor.getString(cursor.getColumnIndex("langId")));
                listCoursesFilterModel.setIsSelected(cursor.getString(cursor.getColumnIndex("isSelected")));
                listCoursesFilterModel.setIdentifier(cursor.getString(cursor.getColumnIndex("identifier")));
                listCoursesFilterModel.setTitle(cursor.getString(cursor.getColumnIndex("title")));
                listCoursesFilterModel.setCount(cursor.getInt(cursor.getColumnIndex("count")));
                list.add(listCoursesFilterModel);
            } while (cursor.moveToNext());
        }
        return list;
    } catch (Exception ex) {
        Throwable t = new Throwable(ex).fillInStackTrace();
        FirebaseCrash.report(t);
        return Collections.emptyList(); // 异常时返回空列表而非null，更安全
    } finally {
        if (cursor != null) {
            cursor.close();
        }
    }
}

关键优化点 #

• 参数数组的正确构建：每个语言ID对应一个参数，确保SQL能正确匹配多个值；
• 空列表处理：避免传入空列表时生成IN()这种无效的SQL语法；
• 异常返回值优化：返回空列表而非null，调用方无需额外处理NullPointerException；
• 代码可读性提升：用StringJoiner替代StringBuilder构建问号列表，逻辑更清晰。

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