Hyperf 2.2 不支持跨库 with() 预加载，因底层使用单连接池子查询，无法跨库 JOIN 或 IN；替代方案为手动分两步查或显式切换连接。
Hyperf 2.2 的模型关联不支持 Laravel 风格的 morphTo/morphMany，但一对一、一对多、多对多这三类基础关系完全可用——前提是严格按约定建表、正确声明外键、避免跨库误用。
怎么写 hasOne / belongsTo 才不会查出 null
Hyperf 的 hasOne 和 belongsTo 行为和 Laravel 一致，但不会自动 fallback 到错误字段。常见空结果原因有：
- 外键字段名不匹配：比如
User::posts()默认查posts.user_id，若实际是posts.author_id，必须显式传参 - 主键名非
id：若User表主键是uid，hasOne第三个参数得补上'uid' - 反向关系写反：外键在当前模型表里 → 用
belongsTo；在外键在对方表里 → 用hasOne或hasMany
示例（User 拥有一个 Profile）：
// User.php
public function profile()
{
return $this->hasOne(UserProfile::class, 'user_id', 'id');
}
// UserProfile.php
public function user()
{
return $this->belongsTo(User::class, 'user_id', 'id');
}
hasMany 预加载 with() 为什么还是 N+1
Hyperf 的 with() 在 2.2 版本已支持预加载，但容易因以下原因失效：
- 没调用
get()或find()等触发查询的方法，只链式写了with()不会执行子查询 - 关联模型没指定
$table或表名与默认约定不符，导致构建子查询时表名错误 - 使用了协程并发但未正确 await，例如
go(function () { $users = User::with('posts')->get(); });会导致主查询和子查询不同步
正确写法：
$users = User::with('posts')->where('status', 1)->get();
// 或单条
$user = User::with('profile')->find(123);
belongsToMany 中间表怎么配才不报错
Hyperf 的 belongsToMany 不自动推导中间表名和字段，必须全量指定，否则查不到数据或绑定错行：
- 中间表名不是
role_user？第 2 个参数填真实表名，如'user_roles' - 中间表字段不是
user_id/role_id？第 3、4 个参数分别填「当前模型在中间表的外键」和「关联模型在中间表的外键」 - 顺序不能颠倒：第 3 个是当前模型（如 User）对应的字段，第 4 个是关联模型（如 Role）对应的字段
示例（User 和 Role 多对多）：
// User.php
public function roles()
{
return $this->belongsToMany(Role::class, 'user_roles', 'user_id', 'role_id');
}
跨数据库关联能不能用 with()
不能。Hyperf 的 with() 底层走的是单连接池的子查询（IN + eagerLoadRelation），无法跨库 JOIN 或 IN 查询。如果 User 在 default 库，Post 在 order_db，直接 with('posts') 会报错或返回空。
替代方案只有两种：
- 手动分两步查：先查
User，再用 IDs 查Post，自己映射关系 - 把关联逻辑提到服务层，用
Hyperf\Contract\ConnectionInterface显式切换连接，但需自行处理懒加载和缓存
这个限制在 2.2 是硬性约束，不是配置问题——框架没提供跨库 eager load 的实现路径。
