ThinkPHP查询报错主因是模型未继承think\Model、字段非法、逻辑括号缺失、变量传参失效；需确认模型类extends Model，开启$strict=true校验字段，闭包规范OR逻辑，动态条件用数组聚合或when()并显式return。
ThinkPHP查询条件构建报错，多数不是语法写错，而是底层机制没对上——模型没继承、字段非法、逻辑括号缺失、变量传参失效，这几类占了八成以上。
模型类没继承 think\Model
控制器里一调 User::where() 就报 Call to undefined method，根本原因就一个：模型类不是真正的模型。
- 打开
app\model\User.php，确认开头有use think\Model;且类定义是class User extends Model - 如果写了
use think\db\Query或压根没extends，那它只是个普通 PHP 类，不支持链式查询 - TP6.1+ 推荐直接用静态调用
User::where(...)->select()，别写(new User())->where(...)
字段名错误或非法参数导致静默失效
查不到数据却没报错？很可能是字段拼错了，比如把 user_name 写成 username，TP 默认跳过非法字段，生成 WHERE 0=1 这种恒假条件。
- 开启严格模式：在模型中加
protected $strict = true; - 手动校验输入字段：用
(new User())->getSchemaFields()拿出合法字段列表，再比对用户传入的 key - JSON 字符串（如
extra={"level":2}）不能直接塞进where()，会触发解析错误，需提前过滤或转义
whereOr 和闭包嵌套逻辑混乱
whereOr('type', 'vip') 看似简单，但和多个 where() 混用时，SQL 括号层级极易出错。
立即学习“PHP免费学习笔记（深入）”；
-
User::where('status', 1)->where('name', 'a')->whereOr('score', '>', 95)实际是(status=1 AND name='a') OR score>95 - 想表达
(status=1 OR type='vip') AND deleted_at IS NULL，必须用闭包包裹 OR 部分：where(function ($q) { $q->where('status', 1)->whereOr('type', 'vip'); })->whereNull('deleted_at') - 闭包里第一个条件用
where还是whereOr不影响括号内逻辑，但闭包外混用会破坏分组意图
动态条件拼接时覆盖或空值误查
循环里反复调 $query->where($k, $v) 很危险：同字段多次调用会覆盖，空值未判空会导致查出意外结果。
- 推荐先收条件到数组：
$where = [];，再按需追加：if (!empty($input['title'])) $where['title'] = ['like', "%{$input['title']}%"]; - 用
when()时，闭包内必须显式return $query->where(...)，漏掉return条件就丢了 - 判断变量是否该参与查询，别直接传
$status，改用!is_null($status)或is_numeric($uid)，避免0、""被当成 false 跳过
