Ubuntu20下Laravel8+MySQL通过id查询部分用户返回null问题

DevOps 小满

2026-9-1

问题现象

调用$users = Users::get();执行全量用户查询时，可正常返回并展示所有用户数据
同一张用户表调用$user = User::find($id);按ID查询单用户时，部分确认存在的用户始终返回null
将数据库导出到本地环境运行时，相同查询逻辑可正常返回对应用户数据

运行环境

MySQL 8.0.29-0ubuntu0.20.04.3（Linux x86_64，Ubuntu发行版）
PHP 7.4.11
Laravel 8

排查与修复步骤

按下面顺序逐一排查，90%的同类问题都能在前3步定位：

优先核对模型一致性（最高发原因）
代码里全量查询用的是Users（复数）模型，单条查询用的是User（单数）模型，先确认两个模型的配置是否一致：
- 检查两个模型的$table属性是否指向同一张用户表。Linux环境下MySQL默认开启表名大小写敏感，要是单条查询用的User模型配置的表名大小写和实际表名不匹配，就会查询异常；而本地Windows/macOS环境MySQL默认表名大小写不敏感，不会触发这个问题，刚好符合“本地正常线上异常”的特征。
- 检查两个模型是否引入了相同的trait、配置了相同的全局作用域：如果User模型引入了SoftDeletes软删除、或者加了多租户过滤、状态过滤之类的全局作用域，而Users模型没有加这些限制，就会自动过滤掉部分数据返回null。
- 直接打印两个查询生成的原生SQL做对比，一眼就能看出差异：
```
DB::enableQueryLog();
// 分别执行全量查询、单条查询
$users = Users::get();
$user = User::find($id);
// 打印所有执行的SQL，对比表名、where条件、是否有额外过滤规则
dump(DB::getQueryLog());
```
排查传参与主键配置问题
- 先确认传入的$id格式正确：检查参数前后是否带空格、换行等不可见字符，如果主键是数字类型，先强转成整型再测试：$user = User::find((int)$id);，部分场景下参数带隐式字符会导致MySQL隐式类型转换匹配失败。
- 核对User模型的主键配置：如果用户表主键不是默认的id字段，或者主键是UUID这类字符串类型、不是自增主键，必须在模型里显式配置对应参数，否则find方法会用默认规则拼接查询条件，导致匹配失败：
```
// 主键不是id时需要配置
protected $primaryKey = '你的主键字段名';
// 主键是字符串类型（如UUID）时需要配置
protected $keyType = 'string';
// 主键非自增时需要配置
public $incrementing = false;
```
- 拿到传入的$id直接在数据库客户端执行原生SQL验证：SELECT * FROM 你的用户表 WHERE id = 传入的id值;，如果原生SQL都查不到，就是id值本身有问题，和框架无关。
排查数据库连接与路由问题
- 检查两个模型的$connection属性，确认是否连接的是同一个数据库。如果Laravel配置了读写分离，要确认是否存在单条查询走从库、从库数据同步延迟/数据不全，全量查询走主库/命中缓存的情况。
- 临时用DB类写原生查询做对照，排除模型配置干扰：
```
$user = DB::table('正确的用户表名')->where('id', $id)->first();
```
  如果这个查询能返回正确结果，问题100%出在User模型的配置上，回到第一步核对模型所有配置项即可。
针对性验证快速定位
- 临时关闭User模型的所有全局作用域测试：$user = User::withoutGlobalScopes()->find($id);，如果能查到结果，就是某个全局作用域加了额外过滤条件，逐一排查对应作用域逻辑即可。
- 如果模型开了软删除，临时加上withTrashed测试：$user = User::withTrashed()->find($id);，能查到的话说明对应用户已经被软删除，全量查询用的Users模型默认没开软删除或者自动带了withTrashed条件。

内容的提问来源于stack exchange，提问作者iohan sandoval

Ubuntu20下Laravel8+MySQL通过id查询部分用户返回null问题

运行环境 #

运行环境