在Firebase Data Connect中用GraphQL Mutations添加自引用种子数据遇错求助

错误原因 #

你遇到的misaligned columns: extra parentId错误，本质是Schema定义和突变传入的字段不匹配：当用@ref定义关联时，Firebase Data Connect不会自动生成parentId字段，数据库里根本没有这个列，所以传parentId会被判定为多余字段。

两种正确实现方案 #

方案1：保留双向关联（@hasInverse）

适合需要双向查询父/子分类的场景，插入时必须用嵌套的parent对象传入关联ID，不能直接用parentId：

正确Schema：

type Category @table(name: "Categories", singular: "category", plural: "categories", key: ["id"]) {
  id: UUID! @default(expr: "uuidV4()")
  name: String!
  description: String
  active: Boolean
  parent: Category @hasInverse(field: "children")
  children: [Category]
}

正确insertMany突变：

mutation {
  category_insertMany(
    data: [
      {id: "11111111-2222-3333-4444-555555555555", active: false, description: "", name: "Clothing & Accessories"},
      {
        id: "22222222-3333-4444-5555-666666666666", 
        parent: {id: "11111111-2222-3333-4444-555555555555"}, 
        active: false, 
        description: "", 
        name: "Adult Clothing"
      }
    ]
  ) {
    affectedCount
  }
}

方案2：单向关联+显式外键字段

如果只需要单向查询父分类，想用parentId传值，必须在Schema里显式定义外键字段，再用@ref关联到父分类：

正确Schema：

type Category @table(name: "Categories", singular: "category", plural: "categories", key: ["id"]) {
  id: UUID! @default(expr: "uuidV4()")
  name: String!
  description: String
  active: Boolean
  # 先定义数据库实际存在的外键列
  parentId: UUID
  # 关联到父分类，指定关联的外键字段
  parent: Category @ref(field: "parentId")
}

正确insertMany突变：

mutation {
  category_insertMany(
    data: [
      {id: "11111111-2222-3333-4444-555555555555", active: false, description: "", name: "Clothing & Accessories"},
      {
        id: "22222222-3333-4444-5555-666666666666", 
        parentId: "11111111-2222-3333-4444-555555555555", 
        active: false, 
        description: "", 
        name: "Adult Clothing"
      }
    ]
  ) {
    affectedCount
  }
}

关键注意点 #

• Firebase Data Connect的关联字段不会自动生成对应的数据库列，必须要么用嵌套对象传关联ID，要么显式定义外键列再关联。
• 修改Schema后，记得重新生成Data Connect客户端代码并重启模拟器，确保Schema变更生效。

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