如何在Directus中构建父子集合树视图并解决外键约束报错

报错原因 #

你抛出的外键错误核心原因是关联字段类型不匹配：日志显示你尝试将Unterkategorien表的name字段（字符串类型）作为外键，关联Kategorien表的id字段（通常为整数类型）。MySQL 外键约束要求关联字段与被引用字段的数据类型、字符集、排序规则完全一致，类型不匹配时会直接抛出ER_CANNOT_ADD_FOREIGN错误。
同时你当前尝试拆分父分类、子分类为两张独立表的思路，本身不符合 Directus 树视图的实现逻辑，这也是配置出错的根本原因。

正确配置步骤 #

Directus 的树结构基于单表自关联实现，不需要拆分父子表，具体操作如下：

• 新建/调整集合结构：所有分类、页面数据存在同一张集合内，比如命名为categories，先配置基础字段：
  • id：默认主键，使用自增整数类型（MySQL 5.7 环境下不建议用 UUID 做主键，会有外键性能问题）
  • name：树节点展示名称，字符串类型
  • 其余业务字段（比如访问路径、内容、排序值等）按需正常添加
• 添加父级关联字段：新建字段，类型选择多对一（Many to One），配置项如下：
  • 关联目标集合选择当前集合本身（即categories，自关联是父子关系的核心）
  • 字段名建议设为parent，用于存储当前节点的父级 ID
  • 外键字段类型必须和主键id完全一致，比如主键是 INT，该字段就选 INT，同时开启「允许为空」（根节点无父级）
  • 删除规则选择SET NULL即可，父节点删除时子节点自动转为根节点，避免级联删除丢失数据
• 配置树视图布局：进入集合的设置页，找到「布局预设」，新增预设并选择「树视图（Tree View）」，配置对应参数：
  • 上级关联字段选择刚才创建的parent字段
  • 节点标题字段选择name（即树节点上要显示的文本字段）
  • 按需配置默认展开层级、节点排序规则即可
• 可选增强配置：如果需要在父节点编辑页直接管理所有子节点，可以新增一个**一对多（One to Many）**字段，字段名设为children，关联目标为当前categories集合，关联外键选择parent字段，保存后即可在父节点详情页直接查看、新增、拖拽排序下属子节点。

环境适配注意事项 #

• 你使用的 Directus 9.13.1 + MySQL 5.7 环境下，树结构嵌套深度建议不要超过 10 层，否则会出现列表加载卡顿问题
• 不要为父子层级建立独立表，树视图仅支持单表自关联的结构
• 配置外键时如果仍报错，检查两个关联字段的排序规则、是否无符号属性完全一致即可。

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