Directus项目中排序字段在编辑后异常重置问题解析

在Directus项目开发中，使用多对多(M2M)或多对任意(M2A)关系构建页面区块时，开发者可能会遇到一个典型问题：当编辑某个区块后，该区块的排序位置会被重置到列表末尾。这种现象严重影响了内容管理系统的用户体验。

问题本质

该问题的核心在于排序字段的保存机制存在缺陷。当用户通过编辑界面修改区块内容时，系统仅提交了被修改的字段数据。由于排序字段(sort)未被显式修改，在后续处理过程中，系统错误地将其视为未定义值，从而触发了排序重置逻辑。

技术背景

在Directus的架构设计中，排序功能通常通过专门的sort字段实现。对于M2M和M2A关系，系统使用useRelationMultiple钩子来管理关联项。编辑操作通过getItemEdits函数收集修改内容，而applySort函数负责处理排序逻辑。

问题复现路径

1. 用户打开包含有序子集合的父级集合
2. 编辑其中一个子项并保存
3. 系统处理流程：
   • 收集编辑字段时遗漏sort字段
   • 将未包含sort字段的数据视为新项
   • 自动分配新的排序值（通常是最大值+1）
4. 导致被编辑项跳转到列表末尾

解决方案

经过技术团队分析，修复方案需要确保：

1. 在编辑操作中始终保留原始排序值
2. 修改getItemEdits函数逻辑，使其在收集编辑内容前先获取当前sort值
3. 确保所有返回路径都包含原始sort字段
4. 该方案同时适用于M2M和M2A关系类型

影响范围

该问题主要影响以下场景：

• 使用区块构建器的页面编辑
• 任何包含有序子集合的父级集合
• 批量编辑操作（单个编辑已修复）
• 使用useRelationMultiple钩子的所有接口

最佳实践建议

开发者在实现类似排序功能时应注意：

1. 显式处理排序字段的持久化
2. 在编辑操作中保留所有系统字段
3. 对批量操作进行特殊处理
4. 在前端和后端同时验证排序一致性

该问题的修复体现了Directus团队对数据完整性的重视，也为开发者处理类似问题提供了参考范例。