SQLite中numColumns返回大于0但fetchArray返回false是什么原因？

问题复现代码 #

$res = $db->query("query...");
$res->numColumns(); // outputs: 14
$res->fetchArray(1); // outputs: false
$db->lastErrorMsg(); // outputs: unknown error
$db->lastErrorCode(); // outputs: 101 (SQLITE_DONE) 

核心误区澄清 #

numColumns返回的是SQL语句解析后预设的返回字段数量，仅和查询语句的结构有关，和是否命中数据、结果集是否为空完全无关。只要是语法合法的SELECT类查询，哪怕没有匹配到任何行，numColumns都会返回对应设置的字段数。

另外你拿到的错误码101对应SQLITE_DONE，本身不是错误状态码，代表SQL语句已经正常执行完成，没有更多结果可以返回，所以lastErrorMsg返回未知错误属于正常情况，没有实际运行错误产生。

可能的原因 #

• 查询没有命中任何匹配行
  这是最高发的场景，比如你的SELECT语句WHERE条件筛选不到任何符合要求的数据，数据库会正常解析出你要查询14个字段，所以numColumns返回14，但因为没有匹配的行，第一次调用fetchArray就直接返回false，进入SQLITE_DONE状态。
• 结果集已经被提前遍历完成
  如果在你调用当前的fetchArray之前，已经有其他逻辑调用过fetchArray、fetchAll等遍历方法读完了整个结果集，此时再调用读取方法就会返回false。哪怕结果集原本有数据，二次遍历也会触发这个现象，你可以尝试调用结果集的reset()方法重置指针后再读取验证。
• 执行了非查询类语句/多语句混合执行
  如果你的SQL实际是INSERT/UPDATE/DELETE这类写操作语句，或者同时执行了多条语句，第一条语句执行完成后就进入SQLITE_DONE状态，还没获取到后续SELECT语句的结果，也会出现类似现象。

排查方案 #

• 把实际执行的SQL语句打印出来，直接放到SQLite官方客户端中执行，确认是否真的有返回行，如果客户端执行也返回空结果，说明是查询条件的问题，属于正常逻辑。
• 检查代码中$res结果集的调用链路，确认在你调用fetchArray之前有没有其他逻辑遍历过结果集。
• 确认你调用的query方法是否支持返回结果集，有没有误用为执行写操作的exec类方法。

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