React-JSONSchema-Form 中数组字段默认值问题的深度解析

问题现象

在使用React-JSONSchema-Form构建表单时，开发者可能会遇到一个特殊的行为：当表单中包含带有默认值的数组字段时，如果配置了mergeDefaultsIntoFormData: 'useFormDataIfPresent'选项，数组中的字段将无法被清空。而有趣的是，这种限制仅出现在数组直接包含的字段上，对于嵌套在其他对象结构中的字段则不受影响。

技术背景

React-JSONSchema-Form是一个基于JSON Schema规范的表单生成库，它允许开发者通过JSON Schema定义表单结构和验证规则。其中，mergeDefaultsIntoFormData是一个重要的配置选项，它控制着默认值如何与表单数据合并：

• useFormDataIfPresent：优先使用表单中已有的数据，仅在字段为空时应用默认值
• always：总是合并默认值
• never：从不合并默认值

问题根源分析

经过深入分析，这个问题源于库在处理数组字段时的特殊逻辑。当字段直接作为数组项存在时，表单引擎在评估是否应用默认值时采用了不同的策略：

1. 数组项处理：对于直接作为数组元素的字段，即使显式设置为空值，表单引擎仍会优先应用默认值
2. 嵌套字段处理：对于嵌套在对象结构中的字段，空值能够正确覆盖默认值

这种不一致的行为表明在表单引擎的数组处理逻辑中存在特殊的分支判断，导致默认值应用策略未能统一。

解决方案探讨

针对这个问题，开发者可以考虑以下几种解决方案：

1. 调整默认值策略：将mergeDefaultsIntoFormData设置为never，完全禁用默认值自动填充
2. 自定义字段组件：为数组项创建自定义组件，手动控制默认值逻辑
3. 表单后处理：在提交前对表单数据进行清理，移除不希望保留的默认值
4. 修改Schema结构：将数组项包装在对象中，利用嵌套字段的正常行为

最佳实践建议

为了避免这类问题，建议开发者在设计表单Schema时：

1. 谨慎使用数组直接包含简单类型字段，考虑使用对象包装
2. 明确测试各种默认值策略下的表单行为
3. 对于关键字段，考虑使用自定义组件获得更精确的控制
4. 在复杂场景下，结合表单生命周期方法进行数据修正

总结

React-JSONSchema-Form的这一行为揭示了表单引擎在处理不同类型字段时的内部差异。理解这些差异有助于开发者构建更健壮的表单系统。虽然目前的行为可能被视为一个限制，但通过合理的Schema设计和适当的变通方案，开发者完全可以实现所需的业务逻辑。