如何在 TypeORM 中为实体添加嵌套对象数组字段-js教程-PHP中文网

如何在 TypeORM 中为实体添加嵌套对象数组字段

本文介绍在 typeorm 中为实体高效存储嵌套对象数组（如图标列表）的两种主流方案：使用 jsonb 字段直接序列化，或通过一对多关系建模；重点演示 jsonb 方式，兼顾类型安全与开发简洁性。

在实际业务中，常需将结构化但非强关联的数据（如 icons 数组）作为字段嵌入主实体，而非单独建表。TypeORM 提供了灵活支持——推荐优先采用 jsonb 类型（PostgreSQL）或 json 类型（MySQL/SQLite）直接存储对象数组，既保持数据内聚性，又避免过度规范化带来的复杂 JOIN 查询。

✅ 推荐方案：使用 @Column({ type: 'jsonb' })（PostgreSQL）

// icons.interface.ts
export interface Icon {
  icon: string;
  main: boolean;
}

// category.entity.ts
import { Entity, PrimaryGeneratedColumn, Column } from 'typeorm';

@Entity()
export class Category {
  @PrimaryGeneratedColumn()
  id: number;

  @Column()
  title: string;

  // ✅ 存储 Icon[] 数组，自动序列化/反序列化
  @Column({ type: 'jsonb', nullable: true, default: () => '[]' })
  icons: Icon[];
}

⚠️ 注意：default: [] 在 TypeScript 中会被忽略（因装饰器无法运行时计算），应改用 default: () => '[]' 确保数据库默认值生效。MySQL 用户请替换为 { type: 'json', default: () => '[]' }。

? 使用示例

// 创建带图标的数据
const category = new Category();
category.title = 'Title text';
category.icons = [
  { icon: 'icon-1.png', main: true },
  { icon: 'icon-2.png', main: false },
  { icon: 'icon-3.png', main: false }
];

await repository.save(category);

查询时，icons 字段将自动解析为 Icon[] 类型数组，可直接遍历或解构：

const loaded = await repository.findOneBy({ id: 1 });
console.log(loaded.icons[0].icon); // "icon-1.png"

? 替代方案：关系型建模（适用需独立查询/索引/约束场景）

若需对 icon 单独建立索引、关联其他表，或频繁按 main = true 查询，则建议拆分为独立实体：

Expanso json-flatten

通过 CLI 或 MCP 服务器，使用 Expanso Edge 管道扁平化嵌套 JSON 对象。

下载

@Entity()
export class Icon {
  @PrimaryGeneratedColumn()
  id: number;

  @Column()
  icon: string;

  @Column({ default: false })
  main: boolean;

  @ManyToOne(() => Category, category => category.icons)
  category: Category;
}

@Entity()
export class Category {
  // ... 其他字段
  @OneToMany(() => Icon, icon => icon.category, { cascade: true })
  icons: Icon[];
}

此时需手动管理关联，增删更复杂，但灵活性与数据库能力更强。