Db::query() 返回原生二维数组，非Collection对象，无法链式调用map()等方法；需手动用think\Collection::make()或new think\Collection()转换。
Db::query() 返回的是数组，不是 Collection 对象
很多人以为 Db::query() 和 select() 一样能直接链式调用 map()、filter()，结果报错 Call to undefined method array::map()。这是因为 Db::query() 永远返回 PHP 原生二维数组，哪怕配置了 'resultset_type' => 'collection' 也无效。
如果你需要对原生 SQL 查询结果做函数式处理，必须手动转成 Collection：
\think\Collection::make(Db::query('SELECT * FROM user WHERE status = ?', [1]))- 或者用更安全的构造方式：
new \think\Collection(Db::query(...)) - 注意：不能直接
Db::query(...)->map(...)，会直接报错
Db::table()->select() 默认返回 Collection，但 Db::query() 不继承任何配置
Db::table('user')->select() 返回的是 think\Collection 实例（前提是没改过全局配置），所以能直接 ->filter()、->column('name')；而 Db::query() 是底层 PDO 封装，绕过了所有模型/查询构建器逻辑，包括 resultset_type、事件钩子、类型转换等。
常见误判场景：
立即学习“PHP免费学习笔记（深入）”；
- 在事务中混用
select()和query()，结果一个支持isEmpty()，另一个只能用empty()判断 - 用
query()查数据后想调->toArray()—— 其实它本来就是数组，调了也没错，但纯属多余 - 依赖
before_select事件统一加日志或权限过滤？query()完全不触发该事件
什么时候必须用 Db::query()，而不是 select()？
不是“能用 select() 就不用 query()”，而是某些场景 select() 根本做不到：
- 复杂 UNION 查询：
Db::query('SELECT id FROM user UNION SELECT uid FROM admin') - 带变量的动态排序：
Db::query("SELECT * FROM user ORDER BY {$safeField} DESC")（注意：字段名必须白名单校验） - 跨库查询（非同一连接）：
Db::query('SELECT u.name, o.total FROM db1.user u JOIN db2.order o ON u.id = o.uid') - 调用存储过程：
Db::query('CALL get_user_stats(?, ?)', [$start, $end])
这些情况强行套 select() 会抛出语法错误或生成非法 SQL —— 因为 select() 的查询构建器只支持单表 + 标准 JOIN 语法。
原生查询后想用 Collection 方法，最简健壮写法
别写三行判断是否为空再转集合，也别重复 new 多次。推荐封装一个复用函数或 Trait：
function queryAsCollection(string $sql, array $params = []): \think\Collection
{
return \think\Collection::make(Db::query($sql, $params));
}然后直接用：
$users = queryAsCollection('SELECT * FROM user WHERE created_at > ?', [$time])->filter(fn($u) => $u['status'] === 1);$names = queryAsCollection('SELECT name FROM user')->column('name');
关键点：这个函数不处理异常、不校验参数、不兼容分页 —— 它就干一件事：把 query() 结果稳稳接住，喂给 Collection。其他逻辑交给上层决定。
最容易被忽略的是：Db::query() 的返回值可能为 false（如 SQL 语法错误），而 \think\Collection::make(false) 会构造出一个空集合，掩盖原始错误。线上环境务必先检查 Db::getLastSql() 和 Db::getError()。
