ThinkPHP中find()返回null不等于数据库连接失败，需先用PDO直连验证是否真连通，再查日志、.env配置及主键/表名/条件等具体原因。
ThinkPHP模型调用find()返回null，不等于数据库连接失败；但两者常被混为一谈。先确认是“连不上”，还是“连得上但查不到”——这是排查的起点。
第一步：绕过模型，直连验证数据库是否真通
别只看模型代码或配置文件，用最底层的PDO连接测试：
-
Db::connect('mysql')->query('SELECT VERSION()')—— 成功返回MySQL版本号，说明驱动加载、配置生效、网络可达 -
Db::name('user')->where('id', 1)->find()—— 若这句返回null，但上一句成功，则问题出在表、数据、主键名或条件本身，不是连接失败 - 特别注意：PostgreSQL 配置里写了 charset 就会静默失效；MySQL 的 host 写成 localhost 在 Docker 或 Windows 下很可能连错目标（localhost 指容器自身，不是宿主机）
第二步：看错误信息里的 PDOException message
打开 runtime/log/ 下最新日志，定位带 PDOException 的行，紧盯 message 字段：
- Connection refused → MySQL服务未启动，或 host/port 不通（比如Docker没暴露3306端口）
-
Access denied for user → 账号密码错误，或该用户只允许从
localhost连，而PHP运行在容器/Nginx中 -
No such file or directory → 配置用了
localhost，但MySQL没启用socket，或路径不对（常见于Mac M1 Homebrew安装）
第三步：检查 .env 是否真正生效
.env 文件在前后端分离项目中容易“看似配置了，实则没加载”：
立即学习“PHP免费学习笔记（深入）”；
- 必须放在项目根目录（和
think命令同级），不能在config/或app/下 -
APP_DEBUG=true必须开启，否则环境变量加载逻辑会被跳过 - 键名必须全大写+下划线，如
DB_HOST=127.0.0.1；写成db_host或Db_Host都无效 - 临时加一行
dump(env('DB_HOST'));，输出null就说明上面某条不满足
第四步：确认 find() 返回 null 的真实原因
即使连接成功，find() 也常返回 null，但原因各异：
-
主键字段名不匹配：默认按
id查，你的表主键是uid或user_id？需显式指定：->pk('uid') -
表名或前缀错位：用
(new User())->getTable()打印实际解析的表名，对比数据库真实表名；检查prefix是否字符串、末尾有无空格 -
查询条件无匹配数据：用
count()替代find()判断是否存在更可靠，例如Db::name('user')->where('status', 1)->count() > 0 -
链式调用未判空就继续操作：如
->find()->toArray()，一旦find()是null就报Call to a member function on null；应改用is_null($user) ? ... : $user->toArray()或data_get($user, 'name', '')
