ThinkPHP模型查询返回空数组通常因表前缀不匹配、字段名拼写错误或软删除字段过滤所致：需核对database.php中prefix配置与实际表名是否一致，确认字段名大小写及下划线规范，检查delete_time等软删字段值是否非NULL导致默认被过滤。
ThinkPHP模型查询返回空数组，通常不是代码写错了，而是几个关键配置或数据状态没对上。重点盯住三处：表前缀是否匹配、字段名是否拼写正确、软删除字段是否拦住了数据。
检查表前缀是否一致
模型类里如果没显式指定数据表名，ThinkPHP会自动拼接 数据库配置里的表前缀 + 模型名（小写、复数形式）。比如配置前缀是 tp_，模型叫 User，默认查的就是 tp_user 表。
- 确认
config/database.php中'prefix' => 'tp_'和实际表名前缀一致 - 在模型中用
protected $table = 'user';显式指定表名，可跳过前缀拼接 - 用
php think schema:build或直接查数据库，看真实表名是不是你预期的
核对字段名是否准确
ThinkPHP 默认开启字段缓存和严格模式，字段名写错（大小写、下划线、多一个空格）会导致查不到数据，甚至静默返回空数组。
- 打开调试模式（
'app_debug' => true），看 SQL 日志里生成的查询语句，复制出来在数据库里手动执行，验证是否真没数据 - 字段名统一用小写+下划线，如
user_name，避免混用驼峰（userName）除非已配置'auto_write_timestamp' => false等映射规则 - 用
Db::name('user')->getFields()查看当前表实际字段列表，对照模型中where()、field()用的字段名
排查软删除是否过滤了数据
如果模型继承了 SoftDelete，默认所有 select 查询都会加上 delete_time IS NULL 条件。哪怕你没删过数据，只要 delete_time 字段存在且值不为 NULL，记录就被“隐身”了。
立即学习“PHP免费学习笔记（深入）”；
- 检查模型是否用了
use SoftDelete;，以及是否定义了protected $deleteTime = 'delete_time'; - 查数据库，看
delete_time字段有没有非NULL值（比如0、'0000-00-00'或时间字符串） - 临时绕过软删除：用
UserModel::withTrashed()->select()或UserModel::withoutTrashed()->select()测试是否能查出数据
不复杂但容易忽略，逐项排除比反复改查询逻辑更高效。
