应使用 User::findOne() 而非 User::one()，因后者不存在；findOne() 是模型静态方法，支持主键或条件数组查询，返回 null 需判空，复合主键时必须传键值对数组。
用 findOne() 而不是 one() 直接调用
Yii 的 ActiveRecord 查询单条数据，最常踩的坑是误以为 one() 是独立方法——它其实必须挂在查询对象（ActiveQuery）上，不能直接在模型类上调用。而 findOne() 是模型类的静态方法，语义清晰、用法直接，且自动处理主键/条件判断。
常见错误写法：User::one()（报错）、User::find()->where(['id' => 1])->one()（可行但冗余）。
推荐写法：
User::findOne(1); // 主键查询，简洁安全 User::findOne(['status' => 1, 'type' => 'admin']); // 多字段条件，返回匹配的第一条
注意：findOne() 在无匹配时返回 null，不是抛异常，需主动判空。
findOne() 和 find()->where(...)->one() 的实际差异
表面看两者结果一致，但底层行为不同：前者会跳过构建完整查询对象的过程，对主键查询有优化路径；后者强制走完整 ActiveQuery 流程，包括事件触发（如 beforeFind）、默认作用域（defaultScope）和关联预加载配置。
这意味着：
- 如果模型定义了
defaultScope（比如自动加is_deleted = 0），find()->one()会生效，findOne(1)也会生效——它并非绕过作用域 - 但
findOne(['name' => 'test'])不会触发beforeFind事件，而find()->where(...)->one()会 - 性能上差异微乎其微，除非高频调用且条件极简单，否则不必为这点开销换写法
查不到数据时别用 getPrimaryKey() 或 refresh() 补救
有人发现 findOne() 返回 null 后，试图调用 $user->getPrimaryKey() 或 $user->refresh()，这是典型误解——null 不是空模型实例，而是根本没创建对象。
正确做法只有两个：
- 先判空：
$user = User::findOne(1); if ($user === null) { /* 处理不存在 */ } - 需要抛异常时自己封装：
if (($user = User::findOne(1)) === null) throw new NotFoundHttpException();
另外，findOne() 不支持延迟加载或缓存穿透控制，如需强一致性或自定义缓存逻辑，得手动结合 Yii::$app->cache 处理，不能依赖该方法内置行为。
复合主键场景下 findOne() 必须传数组
当模型使用复合主键（比如 ['order_id', 'item_id']），findOne(123) 会失效——它只识别单主键。此时必须显式传关联数组：
OrderItem::findOne(['order_id' => 1001, 'item_id' => 5]);
如果错传成 findOne([1001, 5])，Yii 会当作「按顺序匹配主键字段」尝试构造 WHERE 条件，但实际生成 SQL 可能不符合预期（尤其字段顺序与 primaryKey() 返回不一致时），容易查到错误记录或空结果。
建议始终用键值对数组，避免依赖字段顺序；同时检查模型中 primaryKey() 方法返回是否准确，这是复合主键场景下最易被忽略的配置点。
