findOne返回null是正常设计，需用is_null()或=== null显式判断，避免误判falsy值；关联查询和主从延迟场景也需针对性处理。
findOne 返回 null 是正常行为，不是错误
Yii 的 findOne() 方法查不到记录时明确返回 null，这是设计使然，不是异常或配置问题。你看到 var_dump($user) 输出 NULL，说明查询逻辑本身没毛病，只是数据不存在。
常见误判场景：
- 用
if ($user)判断，结果用户对象存在但$user->status === 0或$user->name === ''，整个对象被当 false 处理，误以为“没查到” - 直接调用
$user->toArray()或$user->save()，触发Fatal error: Call to a member function ... on null - 在视图里裸写
= $user->name ?>，PHP 报Trying to get property 'name' of non-object
必须用 is_null() 或 === null 显式判断
所有对 findOne() 结果的后续操作前，先做空值判断。别省这一步，也别用 empty() 或 isset() 替代。
正确写法示例：
$user = User::findOne(123);
if (is_null($user)) {
throw new NotFoundHttpException('User not found.');
}
// 或
if ($user === null) {
return $this->redirect(['site/error']);
}
为什么不用 if (!$user)？因为 ActiveRecord 对象即使属性为 0、false、''，在布尔上下文中也是 falsy，会和“根本没查到”混淆。
需要转数组时，必须先判空再调用 toArray()
toArray() 是对象方法，null 上不能调用。常见错误写法：User::findOne(123)->toArray() —— 这行代码在查不到时直接报错。
安全做法：
- 控制器中：先判空，再
->toArray() - API 响应中：用
Yii::$app->response->data = $user ? $user->toArray() : []; - 若需固定字段，传参过滤：
$user->toArray(['User' => ['id', 'name', 'created_at']])，避免暴露敏感属性
注意：asArray() 不适用于 findOne() 链式调用（它只对 all() 有效），所以别写 User::find()->asArray()->one()，语法虽不报错，但返回的仍是对象，不是数组。
关联查询中 hasOne 返回 null 更容易被忽略
比如 $user->avatar 是 hasOne(Avatar::class, ['user_id' => 'id'])，查不到头像时返回 null，但开发者常默认“有用户就有头像”，结果在视图里 $user->avatar->url 直接崩掉。
处理建议：
- 模板中始终加判空：
= $user->avatar ? $user->avatar->url : '/default-avatar.png' ?> - 模型中封装 getter：
public function getAvatarUrl() { return $this->avatar ? $this->avatar->url : '/default-avatar.png'; } - 预加载时用
with('avatar')，但别假设它一定不为 null；eager loading 只是减少查询次数，不改变业务逻辑上的可选性
最易被忽略的一点：主从分离环境下，刚插入用户就立刻 findOne()，可能因从库延迟返回 null。此时要强制走主库：User::find()->db(Yii::$app->db->master)->one()，而不是怪 findOne “不准”。
