TypeORM中ProductCategory树形实体循环依赖问题求助

问题根源分析 #

你遇到的循环依赖错误，核心原因有两点：

1. 重复装饰器冲突：父类MedusaProductCategory已经携带@Entity和@Tree装饰器，子类重复添加这两个装饰器后，TypeORM会将子类与父类识别为同名但冲突的实体，触发拓扑排序时的循环依赖检测。
2. 仓库扩展方式错误：直接通过Object.assign并spread核心仓库对象的操作，破坏了TypeORM树形仓库的内部依赖结构，导致仓库与实体间的引用关系混乱。

解决方案 #

1. 修复实体扩展代码 #

移除子类中重复的@Entity和@Tree装饰器——装饰器会随类继承自动生效，无需重复声明：

import { ProductCategory as MedusaProductCategory } from "@medusajs/medusa";
import { Column } from "typeorm";

// 去掉重复的@Entity和@Tree，继承父类装饰器即可
export class ProductCategory extends MedusaProductCategory {
  @Column({ nullable: true })
  breadcrumb_name: string;
}

2. 修正仓库扩展逻辑 #

不要直接spread核心仓库的整个对象，而是基于TypeORM的TreeRepository.extend方法，正确继承核心仓库的原型方法，并确保target指向自定义实体：

import { ProductCategory } from "../models/product-category";
import { dataSource } from "@medusajs/medusa/dist/loaders/database";
import { ProductCategoryRepository as MedusaProductCategoryRepository } from "@medusajs/medusa/dist/repositories/product-category";

// 基于自定义实体获取树形仓库，再扩展核心仓库的原型方法
export const ProductCategoryRepository = dataSource
  .getTreeRepository(ProductCategory)
  .extend({
    // 继承核心仓库的所有原型方法
    ...MedusaProductCategoryRepository.prototype,
    
    // 可在此添加自定义仓库方法示例
    async findCategoriesWithBreadcrumbs() {
      return this.createQueryBuilder("category")
        .select(["category.id", "category.name", "category.breadcrumb_name"])
        .leftJoinAndSelect("category.parent_category", "parent")
        .getMany();
    }
  });

// 显式指定target为自定义实体，避免引用混淆
ProductCategoryRepository.target = ProductCategory;

export default ProductCategoryRepository;

3. 额外检查事项 #

• 执行数据库迁移，确保新增的breadcrumb_name字段已同步到PostgreSQL数据库；
• 在Medusa配置文件中，确认已正确替换默认的ProductCategory实体与仓库，让框架使用你的自定义版本。

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