Formily 表单库中嵌套数组与 void 节点的数据问题解析

问题现象

在使用 Formily 表单库开发复杂表单时，当表单结构中存在两层数组嵌套时，开发者可能会遇到一个特殊问题：void 类型的节点意外出现在最终的表单值(formValues)中。正常情况下，void 节点应当被自动过滤掉，不会出现在提交数据中。

问题复现条件

这个问题在特定场景下才会出现：

1. 表单结构中包含两层数组嵌套
2. 使用自定义开发的 ArrayItems 组件
3. 用户执行添加→输入→删除→再添加的操作流程

技术背景

Formily 是一个强大的表单解决方案，它通过 Schema 驱动的方式管理表单结构。其中：

• void 节点：在 Formily 中表示一个不包含实际值的容器节点，通常用于布局目的
• ArrayItems：是 Formily 提供的数组类型字段管理组件，用于处理动态增减的表单项

问题根源

经过分析，这个问题与组件内部使用的 scheduler(调度器)有关。scheduler 用于优化渲染性能，但在某些时序条件下，它可能导致：

1. 状态更新不同步
2. 节点清理不及时
3. 数据过滤逻辑失效

特别是当使用自定义 ArrayItems 组件时，如果错误地引入了 scheduler 逻辑，就可能破坏 Formily 原有的数据流时序。

解决方案

解决这个问题的关键在于：

1. 移除不必要的 scheduler：检查自定义 ArrayItems 组件中是否有 scheduler 相关配置，将其移除
2. 确保数据流同步：保证数组操作的同步性，避免异步操作干扰数据过滤
3. 使用官方推荐模式：参考官方 ArrayItems 组件的实现方式

最佳实践建议

为了避免类似问题，建议开发者：

1. 优先使用 Formily 官方提供的 ArrayItems 组件
2. 如果必须自定义，确保遵循 Formily 的数据流规范
3. 避免在表单组件中引入不必要的性能优化手段
4. 在复杂场景下，增加表单值的调试输出，便于及时发现异常数据

总结

Formily 作为企业级表单解决方案，虽然功能强大，但在处理复杂嵌套结构时仍需注意数据流的正确性。理解 void 节点的作用机制和数组字段的操作时序，能够帮助开发者避免这类隐蔽的问题。当遇到类似问题时，建议从数据流时序和组件实现细节两方面进行排查。