ThinkPHP查询条件失效主因是查询构造器被提前执行、条件被覆盖或类型不匹配；必须在select()/find()/count()/paginate()前完成所有where链式调用，并注意软删除、全局作用域及真实SQL验证。
ThinkPHP数据查询条件失效，通常不是SQL写错了，而是条件没真正进查询、被后续操作覆盖，或框架机制没对上。核心得盯住“查询构造器是否还活着”“条件有没有被重置”“时间/空值/类型是否踩坑”这三点。
查询构造器提前执行，条件白加
最常见的情况：你写了where()之后又调用了select()、find()、count()等执行方法，再链式调用其他查询——后面的操作其实是在结果集（数组或Collection）上进行，不是在SQL层面加条件。
- ❌ 错误写法：
$list = UserModel::where('status', 1)->select()->where('level', 'vip')->order('id')->select();
第一次select()已查出数据，第二个where()对PHP数组无效，也不会生成新SQL - ✅ 正确写法：所有条件必须在
select()前链完，如UserModel::where('status', 1)->where('level', 'vip')->order('id')->select() - ⚠️ 特别注意
paginate()和count()：它们也属于执行方法，不能放在select()之后；若先select()再count()，返回的会是数组长度，不是数据库真实行数
条件被自动过滤或类型不匹配
ThinkPHP默认会对input()等参数做全局过滤（如trim、htmlspecialchars），也可能因类型不一致导致WHERE失效，尤其是数字字段传了字符串、时间字段传了空值。
- 数字字段慎用字符串条件：比如
where('id', input('id'))，若前端传id=123a，PHP自动转为123，但MySQL可能按'123a'匹配失败；建议显式强转：where('id', (int)input('id')) - 时间字段注意NULL和空字符串：若数据库字段允许NULL，而条件写成
where('update_time', '')，MySQL不会命中NULL行；应改用whereNull('update_time')或where('update_time', 'exp', 'IS NULL') - LIKE模糊搜索记得加通配符：直接
where('name', 'like', 'admin')等价于WHERE name LIKE 'admin'，不是%admin%；要写成where('name', 'like', '%'.input('keyword').'%')
作用域、软删除与全局作用域干扰
模型中定义的scope、softDelete或全局查询范围（如多租户tenant_id自动追加），可能静默修改你的查询，导致结果比预期少甚至为空。
立即学习“PHP免费学习笔记（深入）”；
- 检查模型是否启用软删除：
protected $useSoftDelete = true时，where()默认会自动加上delete_time IS NULL；若想查已删除数据，必须用withTrashed()或onlyTrashed() - 查看是否有全局作用域：在模型中搜
base、scope或globalScope，例如protected $globalScope = ['tenant'];会强制追加where('tenant_id', ...) - 调试真实SQL：在查询后立刻调用
getLastSql()，确认生成的SQL里是否真含你写的条件，而不是被覆盖或删掉了
缓存与预加载导致的数据“滞后”
开启查询缓存后，条件变化但缓存没刷新；或者用with()预加载关联数据时，主表条件没生效到关联表，也会让人误以为条件失效。
- 临时关闭缓存验证：在查询前加
cache(false)，如UserModel::cache(false)->where('status', 1)->select()，排除缓存干扰 - 关联查询条件要明确作用域：若想让关联表也走相同条件，不能只写主表
where()，得用闭包指定：with(['orders' => function ($q) { $q->where('status', 'paid'); }]) - Runtime目录异常也可能影响：若
runtime/cache/被频繁清空或权限不对，框架可能反复编译查询逻辑，偶发条件丢失；检查该目录是否存在且可写
