[TForm] nextTick中调用 clearValidate 方法，无法及时清除校验信息 #6639

Activity

1. huchaomin

   added

   🐞 bugSomething isn't workingSomething isn't working

   🧐 unconfirmedwaiting to be confirmedwaiting to be confirmed

   on May 9, 2026
2. github-actions commented on May 9, 2026

   

   github-actionsbot

   on May 9, 2026 – with GitHub Actions

   Contributor

   More actions

   👋 @huchaomin，感谢给 TDesign 提出了 issue。
   请根据 issue 模版确保背景信息的完善，我们将调查并尽快回复你。
3. guozi9999 commented on May 23, 2026

   

   guozi9999

   on May 23, 2026

   Contributor

   More actions

   https://stackblitz.c

   stackblitz 中的例子好像不能复现这个问题
4. dongyikuan919 commented on May 23, 2026

   

   dongyikuan919

   on May 23, 2026

   Last edited by dongyikuan919

   More actions

   我看了下 TForm / TFormItem 这块，感觉这个问题像是 clearValidate() 和 FormItem 的自动校验 watcher 之间有时序竞争。

   当前 packages/components/form/form.tsx 里的 clearValidate 是同步遍历：

   children.value.forEach((child) => {
     if (isFunction(child.resetHandler) && needValidate(String(child.name), fields)) {
       child.resetHandler();
     }
   });

   但 packages/components/form/form-item.tsx 里同时有：

   watch(value, async () => {
     await validateHandler("change");
   }, { deep: true })

   所以如果业务代码在同一个 tick 里改了表单值，然后马上 nextTick(() => form.clearValidate())，可能出现：clearValidate -> resetHandler 已经清掉错误，但上一轮 value watcher / validateHandler 随后又把错误状态写回来。这个也能解释为什么示例里多写几个 nextTick 才能最终清掉。

   建议加一个回归测试：

   1. 先触发必填错误；
   2. 修改字段值；
   3. 一个 await nextTick() 后调用 clearValidate()；
   4. 再 await nextTick()，断言 .t-is-error 和 .t-input__extra 都被清掉。

   实现上可以考虑两种方向：

   • 让 clearValidate 返回 Promise<void>，内部 reset 后 await nextTick()，确保对外时序稳定；
   • 或在 FormItem 内部加一个 reset/version 标记，clearValidate 后到来的旧 validateHandler 结果不再覆盖 TO_BE_VALIDATED 状态。

   第二种更稳，因为它能处理异步 validator 慢返回覆盖 reset 状态的问题。
5. huchaomin commented on May 25, 2026

   

   huchaomin

   on May 25, 2026

   Author

   More actions

   https://stackblitz.c

   stackblitz 中的例子好像不能复现这个问题

   你注释掉一组 nextTick 就可以复现了
6. dongyikuan919 commented on May 25, 2026

   

   dongyikuan919

   on May 25, 2026

   More actions

   明白了，注释掉一组 nextTick 后确实更容易把时序问题暴露出来。

   我理解这个问题的关键点不是单纯 “nextTick 里调用不生效”，而是 clearValidate 触发时表单项内部校验状态还没有完成同步，导致外层 tick 和字段状态更新 tick 存在先后差。建议后续可以把复现说明补成：保留/注释不同层级 nextTick 时的表现对比，这样维护者更容易判断是文档预期、调用时机问题，还是组件内部需要额外 flush。
7. Wesley-0808

   removed

   🧐 unconfirmedwaiting to be confirmedwaiting to be confirmed

   on May 25, 2026
8. tdesign-bot

   added this to TDesignon May 25, 2026
9. huchaomin commented on Jun 23, 2026

   

   huchaomin

   on Jun 23, 2026

   Author

   More actions

   这个问题还没进展么?
10. dongyikuan919 commented on Jun 24, 2026

    

    dongyikuan919

    on Jun 24, 2026

    More actions

    目前看 issue 里还没有维护者的进一步反馈。

    我这边的理解还是更偏向 clearValidate 和 FormItem 内部 value watcher 触发的 change 校验之间存在时序竞争：clearValidate 已经把错误状态 reset 掉，但前一轮 validateHandler 的结果可能随后又把 error 状态写回来，所以才会表现成需要多层 nextTick 才能最终清掉。

    建议后续可以先补一个最小回归用例把这个时序固定下来：先触发 required 错误 -> 修改字段值 -> await nextTick() 后调用 clearValidate() -> 再 await nextTick() 断言错误态和提示都已清除。修复上单纯让 clearValidate 多等一个 tick 可能不够稳，更建议在 FormItem 内部加 reset/version 标记，避免 clearValidate 之后返回的旧校验结果覆盖 reset 后的状态。