ThinkPHP6模型关联删除需显式配置withDelete(true)且仅实例delete()生效，批量destroy或Query类delete不触发级联；多对多须用detach()操作中间表，失败时应查外键约束、模型配置及SQL日志。
ThinkPHP6模型关联删除失败，不是“删不掉”，而是删了但没删干净——主表数据没了，关联表还留着；或者反过来，关联表清空了，主表却意外被删。问题根源不在语法错，而在关联逻辑、删除方式和事务控制三者没对齐。
关联删除必须显式定义，不能靠约定
TP6不会自动级联删除，哪怕你写了hasMany或belongsToMany，默认也不触发关联表操作。必须在模型中主动声明级联行为：
- 一对一（
hasOne）：在主模型中加->withDelete(true)，如return $this->hasOne(Profile::class, 'user_id')->withDelete(true); - 一对多（
hasMany）：同上，加withDelete(true)，删除主记录时自动删所有子记录 - 多对多（
belongsToMany）：不支持withDelete，需手动处理中间表，例如：User::find(123)->roles()->detach();
用destroy()删主表，关联表未必同步
UserModel::destroy(123)只删user表，即使关联方法里写了withDelete(true)，也仅在调用$user->delete()（实例方法）时生效。常见误操作：
- ❌
UserModel::where('id', 123)->delete()：绕过模型，withDelete完全失效，关联表毫发无损 - ❌
UserModel::destroy([123])：批量删主表，但withDelete不支持批量级联，关联表仍残留 - ✅ 正确做法：先查出模型实例，再调用实例
delete()：$user = UserModel::find(123); $user->delete();
多对多中间表清理要分两步走
用户解绑角色、文章移除标签这类操作，本质是删中间表记录，不是删主/从模型本身。TP6的detach()和attach()才是正解：
立即学习“PHP免费学习笔记（深入）”；
- 清空某用户所有角色：
$user->roles()->detach(); - 只解绑指定角色：
$user->roles()->detach([5, 8]); - 若中间表有额外字段（如
created_at），detach()不支持带条件删除，得手写：Db::name('sys_user_role')->where('uid', $user->id)->delete();
失败时别只看返回值，重点查日志与SQL
$user->delete()返回false却不报错？常见原因有三个，按顺序排查：
- 查数据库：确认关联表外键字段（如
user_id）是否为ON DELETE CASCADE？TP6级联不依赖数据库约束，但若开了，反而可能造成意外连删 - 查模型配置：运行
var_dump($user->profile()->getRelation());，看withDelete是否为true，且关联方法名与调用方式大小写一致 - 开SQL日志：
Db::enableQueryLog(); $user->delete(); dump(Db::getQueryLog());，确认是否真执行了关联表的DELETE语句
