React Testing Library 中 ReactDOMTestUtils.act 弃用问题的分析与解决方案

问题背景

在使用 React Testing Library 进行组件测试时，开发者可能会遇到一个关于 ReactDOMTestUtils.act 弃用的警告信息。这个警告表明测试代码中使用了 React 官方已标记为弃用的 API，需要迁移到新的实现方式。

问题现象

当运行测试时，控制台会输出如下警告：

Warning: `ReactDOMTestUtils.act` is deprecated in favor of `React.act`. Import `act` from `react` instead of `react-dom/test-utils`.

这个警告通常出现在使用自定义 render 函数封装 React Testing Library 的测试场景中。警告明确指出，应该从 react 包而不是 react-dom/test-utils 中导入 act 方法。

技术原理

act 是 React 测试工具中的一个重要方法，它用于确保在测试期间所有与组件相关的更新和效果都被正确处理。在 React 16.9 版本之前，act 方法是通过 react-dom/test-utils 导出的。但随着 React 的发展，官方决定将核心测试工具方法统一到 react 包中，以提高 API 的一致性和易用性。

解决方案

这个问题已经在 React Testing Library 的 15.0.6 版本中得到修复。开发者可以通过以下步骤解决：

1. 升级 @testing-library/react 到最新版本（至少 15.0.6）
2. 确保项目中不再直接或间接从 react-dom/test-utils 导入 act 方法

对于自定义 render 函数的实现，可以保持原有代码不变，因为问题根源在于 React Testing Library 内部实现，而不是用户代码。

最佳实践

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

1. 定期更新测试相关依赖
2. 关注 React 官方文档中关于测试工具的更新说明
3. 在自定义测试工具封装时，优先使用 React 官方推荐的最新 API
4. 建立完善的测试警告监控机制，及时发现并处理弃用警告

总结

React 生态系统的持续演进带来了 API 的改进和优化。作为开发者，及时跟进这些变化不仅能避免弃用警告，还能确保测试代码的长期可维护性。React Testing Library 团队已经快速响应并修复了这个兼容性问题，开发者只需保持依赖更新即可获得最佳实践。