同一数据类型多子实体集合的JHipster导入报错问题咨询

我们的部分数据实体存在多个同一数据类型的子实体集合，尝试用以下JDL定义关联：

entity Parent {
  name String
  headOfHousehold Boolean
}

entity Child {
  name String
}

relationship ManyToOne {
  Child{parent(name)} to Parent{boys}
  Child{parent(name)} to Parent{girls}
}

执行导入命令时触发错误：

Error: Error at entity Parent: relationship name is not synchronized {
    "otherEntityName": "child",
    "otherEntityRelationshipName": "parent",
    "relationshipName": "girls",
    "relationshipType": "one-to-many",
    "otherEntity": "[Child Entity]",
    "otherEntityField": "id",
    "ownerSide": false,
    "collection": true,
    "otherSideReferenceExists": false,
    "otherEntityIsEmbedded": false
} with {
    "otherEntityField": "name",
    "otherEntityName": "parent",
    "otherEntityRelationshipName": "boys",
    "relationshipName": "parent",
    "relationshipType": "many-to-one",
    "otherEntity": "[Parent Entity]"
}

将Child拆分为Boy和Girl实体后，导入可正常执行：

entity Parent {
    name String
    headOfHousehold Boolean
}

entity Boy {
    name String
}

entity Girl {
    name String
}

relationship ManyToOne {
    Boy{parent(name)} to Parent{boys}
    Girl{parent(name)} to Parent{girls}
}

但JPA本身支持如下合法的实体结构：

@Entity
public class Parent {
    @OneToMany(cascade = CascadeType.ALL)
    @JoinColumn(name = "parent_id")
    private Collection<Child> boys;

    @OneToMany(cascade = CascadeType.ALL)
    @JoinColumn(name = "parent_id")
    private Collection<Child> girls;
}

@Entity
public class Child {
    // ...
}

提问：为何JHipster不支持该JPA合法的实体结构？

JHipster的JDL解析规则和JPA的底层支持逻辑存在差异，核心原因在于：

• JDL的关系同步约束：JHipster要求实体间的关系必须双向同步且唯一。最初的JDL中，Child实体只定义了一个parent关联字段，但Parent却有两个反向关联（boys和girls），JDL解析器无法将Child的单个parent字段对应到Parent的两个不同集合，违反了它预设的“一对多关系需双向唯一映射”的校验规则。
• 代码生成的自动化限制：JHipster的核心是自动生成前后端完整代码，它需要明确的关系映射来生成对应的Repository、Service、DTO以及前端页面组件。如果允许一个子实体对应父实体的多个同类型集合，生成器无法自动处理业务逻辑上的区分（比如新增Child时该归属到boys还是girls集合），这超出了它预设的自动化场景边界。
• 简化模型设计的导向：JHipster的设计理念倾向于通过清晰的实体划分简化业务模型，避免模糊的关联关系。拆分实体的方式更符合它倡导的“单一职责”模型设计原则，也能让生成的代码逻辑更清晰，减少后续维护复杂度。

虽然JPA允许这种多集合映射，但JHipster作为代码生成工具，优先保证自身生成逻辑的一致性和自动化能力，因此对JDL的关系定义做了更严格的约束。

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