外键约束是MySQL表结构问题，非ThinkPHP管理；必须在InnoDB表中用FOREIGN KEY显式声明，且被引用列须为主键或唯一索引，字段类型严格一致，否则关联查询失败或插入报错。
外键约束不是ThinkPHP管的事，是MySQL的表结构问题
ThinkPHP本身不创建、不管理数据库外键约束，它只读写数据；外键必须在建表时用FOREIGN KEY语法显式声明，并且依赖InnoDB引擎。你看到“关联查不到数据”，90%不是PHP代码问题，而是orders表根本没真正加上外键约束。
常见错误现象：SQLSTATE[42S22]: Column not found: 1054 Unknown column 'user.id' 或插入子记录时报 Cannot add or update a child row: a foreign key constraint fails——前者说明字段名/主键名对不上，后者说明外键已存在但数据不合法。
- 建外键前必须先给外键字段加索引（如
ADD INDEX idx_user_id (user_id)），否则MySQL直接拒绝 - 必须指定
ENGINE=InnoDB，MyISAM会静默忽略FOREIGN KEY语句 - 被引用的父表（如
users）必须已存在，且被引用字段（如id）要有索引（主键自动带） - 两边字段类型要严格一致：比如
INT不能对INT UNSIGNED，否则报ERROR 1005
hasOne和belongsTo写反了或漏参数，关联就静默失效
ThinkPHP不会报错，只会返回null或空集合。核心原因：它不推断关系，只按你写的参数拼SQL。比如User::with('profile')->find(1)查不到profile，大概率是hasOne里外键名没写对。
默认约定是“关联模型名小写 + _id”，但现实中资料表字段几乎都是user_id，不是profile_id——这个反直觉点就是最常漏的。
立即学习“PHP免费学习笔记（深入）”；
-
hasOne(Profile::class, 'user_id')：第二个参数是关联模型（Profile）里的外键字段名，必须填 -
belongsTo(User::class, 'user_id', 'uid')：第二个参数是当前模型（Profile）的外键字段，第三个是对方模型（User）的主键字段；如果users表主键是uid，不写第三个参数就会去查user.id，直接失败 - 两个方法必须成对定义，单写一个
hasOne，belongsTo那边查不到；单写belongsTo，with()根本不会触发查询
关联写入时绕过模型，外键值就容易出错
别用Db::name('profile')->insert(['user_id' => 1])这种写法补数据。它不经过模型验证、不触发事件、不自动处理时间戳，最关键的是：你得手动保证user_id存在且合法——而外键约束本该帮你拦住非法值。
正确做法是走关联方法的save()：
$user = User::find(1); $profile = new Profile(); $profile->email = 'a@b.com'; $user->profile()->save($profile); // 自动填user_id = 1
-
$user->profile()->save()是对的，调用的是HasOne对象的save方法 -
$user->profile->save()是错的，$user->profile是数据对象（可能为null），没有save方法 - 如果
profile已存在，用$user->profile->email = 'x'; $user->profile->save();也能自动更新，前提是profile_id能正确定位到记录
中间表外键配置错一个字母，belongsToMany就查不到
ThinkPHP 6+ 没有_belongsToMany，只有belongsToMany（无下划线）。而且它不猜中间表字段，全靠你手写参数。比如中间表叫sys_user_role，字段是uid和rid，就必须写死：
public function roles()
{
return $this->belongsToMany(Role::class, 'sys_user_role', 'uid', 'rid', 'id', 'id');
}
- 第2个参数是中间表名（不含数据库前缀）
- 第3个参数是当前模型（User）在中间表的外键字段，比如
uid - 第4个参数是关联模型（Role）在中间表的外键字段，比如
rid - 第5、6个参数分别是两个模型自身的主键名，默认
id，但如果Role表主键是role_id，就得改成'role_id' - 漏掉任意一个，查询SQL里就会出现不存在的字段名，结果为空或报错
Undefined index: pivot
外键约束和模型关联是两层事：约束在数据库层面拦非法数据，关联在PHP层面组织查询逻辑。两者都配错，问题才最难排查——尤其是当数据看似正常、只是关联查不到的时候，最容易忽略建表语句里那行FOREIGN KEY有没有真正生效。
