findOne()是最简洁安全的主键单查方法，自动绑定参数、无需判空；非主键查询须用find()->where()->one()；务必显式判null、避免N+1、注意软删除过滤。
Yii2 中用 findOne() 查单条数据最常用
直接查主键值时，findOne() 是最简洁安全的选择。它自动做 SQL 参数绑定，不会拼接字符串，也不需要手动判断 null。
常见错误是误用 find()->where(...)->one() 去查主键——虽然能跑通，但绕过了框架对主键查询的优化路径，且容易漏掉类型转换（比如把字符串 ID 当整数传）。
-
User::findOne(123)→ 正确，ID 是整数就传整数；字符串主键如User::findOne('abc') -
User::findOne(['status' => 1, 'id' => 123])→ 也合法，等价于 AND 条件 WHERE 查询 - 返回
null表示没找到，不是抛异常，必须显式判空，否则调用属性会报Trying to get property 'name' of non-object
查非主键字段必须用 find()->where()->one()
比如按邮箱、手机号或联合条件查一条记录，findOne() 不支持复杂表达式（如 LIKE、IN、函数调用），只能靠 find() 链式构建。
注意：这里最容易踩的坑是忘记加 ->one()，写成 ->all() 或直接执行，结果拿回的是 ActiveQuery 对象而不是模型实例。
- 查邮箱：
User::find()->where(['email' => $email])->one() - 模糊匹配：
User::find()->where(['like', 'name', $keyword])->one() - 带排序取最新一条：
User::find()->where(['status' => 1])->orderBy(['created_at' => SORT_DESC])->one() - 如果表有软删除字段（如
is_deleted），记得在 where 里加上['is_deleted' => 0]，否则可能查到逻辑删除的数据
查不到数据时别硬访问属性，先判 null
Yii 不会在查不到时自动抛异常，而是安静返回 null。新手常写 $user->name 然后报错，其实只差一行判断。
更隐蔽的问题是：有些业务代码把 findOne() 结果直接传给视图，视图里又没做空检查，上线后用户一刷就 500。
- 正确写法：
$user = User::findOne($id); if (!$user) { throw new NotFoundHttpException(); } - 或者用空合并：
$name = $user ? $user->name : '未知用户'; - 不要写
$user->name ?? 'N/A'—— PHP 7.4+ 虽支持，但$user是 null 时仍会触发 “Cannot access property” 的致命错误
性能和兼容性：别在循环里反复调 findOne()
查单条本身很快，但若在 foreach 里根据每个订单查一遍用户（Order::findAll() 后逐个 User::findOne($order->user_id)），就会产生 N+1 查询问题。
这种情况应该改用 with() 预加载，或者用 ArrayHelper::map() + 一次批量查所有用户 ID。
- 推荐预加载：
Order::find()->with('user')->all()（前提是已定义getuser()关联） - 手动优化：
$userIds = ArrayHelper::getColumn($orders, 'user_id'); $users = User::find()->where(['id' => $userIds])->indexBy('id')->all(); - MySQL 8+ 或 PostgreSQL 可考虑
IN批量查，但注意findOne()不支持数组主键，得换find()->where(['id' => $ids])->all()
