Yii2中删除单条记录的正确写法是先用findOne()获取模型实例，再调用实例的delete()方法并判断返回值（成功为1，失败为0），同时需处理beforeDelete钩子、null检查及事务回滚。
Yii2 中用 delete() 删除单条记录的正确写法
直接调用 delete() 前必须先查出模型实例，否则会报 Calling unknown method: yii\db\ActiveRecord::delete() —— 因为静态方法不支持直接删，得靠已加载的实例。
常见错误是写成 User::delete(['id' => 123]) 或 User::findOne(123)->delete() 却没检查返回值，导致误以为删除成功但实际失败（比如触发了 beforeDelete 返回 false）。
-
User::findOne(123)返回null时调用delete()会抛出Call to a member function delete() on null - 成功删除返回整数
1，失败返回0（不是布尔值），需显式判断 - 若模型定义了
beforeDelete()钩子且返回false，删除会被中止，且不抛异常
$user = User::findOne(123);
if ($user !== null && $user->delete()) {
// 成功：$user 已从 DB 移除，但对象仍存在内存中
} else {
// 失败：可能是 not found、权限拦截、钩子拒绝或数据库约束冲突
\Yii::error('Delete failed for user ID 123: ' . print_r($user->getErrors(), true));
}
用 deleteAll() 谨慎删单条：能用但不推荐
deleteAll() 是静态方法，支持条件数组或 SQL 片段，看似更“直接”，但它绕过模型生命周期（不触发 beforeDelete/afterDelete）、不校验权限、也不加载关联数据，纯 SQL 执行。用于单条记录属于“高危简写”。
- 条件必须严格唯一，否则可能误删多行（例如
['status' => 1]可能删掉一堆） - 返回值是影响行数（
int），无法获取被删记录原始数据 - 事务中使用需自行保证一致性，模型层的业务逻辑全失效
// 不推荐：虽可行，但跳过所有模型层保障
$rows = User::deleteAll(['id' => 123]);
if ($rows === 0) {
// 注意：这里 0 表示没匹配到，也可能是权限/外键阻止删除，无明细错误
}
软删除场景下不能只靠 delete()
如果项目用了软删除（如加 is_deleted 字段），默认 delete() 仍会物理删除——除非你重写了 beforeDelete() 并返回 false，再手动更新状态。
- Yii2 官方不内置软删除，得自己实现；常用方案是覆盖
delete()方法或用行为（Behavior） - 若已引入
yii2-soft-delete等扩展，调用的是softDelete()而非原生delete() - 查询时必须配合全局作用域（
defaultScope）过滤已软删记录，否则逻辑混乱
// 示例：在模型中自定义软删除
public function beforeDelete()
{
$this->is_deleted = 1;
$this->deleted_at = date('Y-m-d H:i:s');
return $this->save(false); // false 表示跳过验证
}
事务内删除失败要主动回滚
多个删除操作组合（如删用户同时删其订单）必须包在事务里，且任一失败就得回滚。Yii 的 delete() 本身不自动开启事务，也不能靠 try-catch 捕获数据库级错误来隐式回滚。
- 用
Yii::$app->db->transaction包裹，不要依赖模型方法自带事务 -
delete()返回false时需手动throw new Exception()触发回滚，否则事务继续执行后续语句 - 外键约束失败（如子表有引用）会抛
IntegrityException，必须 catch 并处理
try {
$transaction = \Yii::$app->db->beginTransaction();
$user = User::findOne(123);
if (!$user || !$user->delete()) {
throw new \Exception('User delete failed');
}
// 其他操作...
$transaction->commit();
} catch (\Exception $e) {
$transaction->rollBack();
throw $e;
}
真实项目里最常被忽略的不是语法，而是 delete() 的返回值判断和钩子函数的副作用——它不报错，却静默失败。
