NestJS中Mikro-ORM嵌套Populate失效：无法获取角色权限

问题场景 #

在NestJS中使用Mikro-ORM框架，定义了UserEntity、RoleEntity和PermissionEntity三类实体，需求是根据邮箱查询用户时，同时获取其关联的角色以及角色对应的权限列表。当前使用的查询代码如下：

this._userRepo.findOne({ $or: [{ email }] }, { populate: ['role', 'role.permissions'] }) 

预期返回结果中角色的permissions字段会包含权限列表，但实际该字段未被加载。预期结果示例：

{
    id: 1,
    email: 'john.doe@inter.net',
    firstName: 'john',
    lastName: 'Doe',
    ...
    role: {
        id: 21,
        name: 'Moderator',
        permissions: [
            { id: 1, name: 'Create' },
            { id: 2, name: 'Update' },
            { id: 3, name: 'Delete' },
        ]
    }
}

实体定义 #

UserEntity (user.entity.ts)

@Entity({ tableName: 'users' })
export class UserEntity {
    @PrimaryKey() id: number;
    @Property() email: string;
    @Property() firstName: string;
    @Property() lastName: string;    
    ...
    @ManyToOne(() => RoleEntity) role: ref<RoleEntity, 'id'>;

    constructor(role: RoleEntity) {
        this.role = ref(role);
    }
}

RoleEntity (role.entity.ts)

@Entity({ tableName: 'roles' })
export class RoleEntity {
    @PrimaryKey() id: number;
    @Property() name: string;
    ...
    @ManyToMany(() => PermissionEntity) permissions = new Collection<PermissionEntity>(this);
}

PermissionEntity (permission.entity.ts)

@Entity({ tableName: 'permissions' })
export class PermissionEntity {
    @PrimaryKey() id: number;
    @Property() name: string;
}

数据库关联表 #

已自动生成roles_permissions关联表，数据示例：

解决方案 #

1. 补全ManyToMany关联的双向配置 #

Mikro-ORM的@ManyToMany关联需要明确双向关系，当前RoleEntity的permissions字段缺少反向关联声明，导致框架无法正确识别关联规则。

• 修改RoleEntity的permissions字段，添加反向关联指向PermissionEntity，并指定拥有方：

@Entity({ tableName: 'roles' })
export class RoleEntity {
    @PrimaryKey() id: number;
    @Property() name: string;
    ...
    @ManyToMany(() => PermissionEntity, permission => permission.roles, { owner: true }) 
    permissions = new Collection<PermissionEntity>(this);
}

• 在PermissionEntity中添加反向关联字段：

@Entity({ tableName: 'permissions' })
export class PermissionEntity {
    @PrimaryKey() id: number;
    @Property() name: string;
    
    @ManyToMany(() => RoleEntity, role => role.permissions)
    roles = new Collection<RoleEntity>(this);
}

{ owner: true }指定RoleEntity为关联关系的拥有方，对应数据库中的roles_permissions表。

2. 调整查询的populate语法 #

使用嵌套对象的形式指定深度关联加载，相比字符串路径更不易出错，确保Mikro-ORM正确解析关联层级：

this._userRepo.findOne({ email }, { 
  populate: {
    role: {
      permissions: true
    }
  }
});

如果坚持使用字符串路径，需确保使用的Mikro-ORM版本支持这种嵌套路径写法（推荐v5及以上版本）。

3. 手动调用EntityManager加载关联（备选方案） #

若上述方法仍未生效，可先加载用户和角色，再手动加载角色的权限：

const user = await this._userRepo.findOne({ email }, { populate: ['role'] });
if (user?.role) {
  await this._em.populate(user.role, ['permissions']);
}
return user;

注：_em需为注入的Mikro-ORM EntityManager实例。

4. 检查延迟加载配置 #

若实体启用了延迟加载，可能导致关联未被主动加载。可在关联注解中添加{ eager: false }关闭自动延迟加载，或确保查询时显式指定populate参数。

内容的提问来源于stack exchange，提问作者Arkadi