Redux Toolkit中Immer与实体适配器的兼容性问题解析

问题背景

在使用Redux Toolkit开发应用时，开发者可能会遇到一个特定错误："[Immer] 'current' expects a draft, got:"。这个问题通常出现在使用实体适配器(Entity Adapter)和监听中间件(listenerMiddleware)组合的场景中，特别是在执行排序状态操作时。

错误本质

这个错误的根本原因是Redux Toolkit内部在处理实体状态时，对Immer的draft状态检查不够完善。具体来说，当开发者使用upsertMany等操作对已排序的实体状态进行修改时，系统会尝试对普通数组(非Immer draft)调用current()方法，而Immer的current()方法只能作用于draft对象。

技术细节

Redux Toolkit的实体适配器提供了对标准化状态的管理能力，包括添加、更新、删除等操作。在排序状态适配器(Sorted State Adapter)中，当执行一系列操作如removeAll()后接upsertMany()时，状态中的ids数组会变成一个普通数组而非Immer draft。此时如果直接调用current(state.ids)就会抛出上述错误。

解决方案

Redux Toolkit团队在2.2.6版本中修复了这个问题。修复方案是增加了一个getCurrent()工具函数，该函数会在调用current()前先检查值是否可以被draft化。这样可以避免对普通值调用current()导致的错误。

最佳实践

为了避免类似问题，开发者应该：

1. 确保使用最新版本的Redux Toolkit(至少2.2.6及以上)
2. 在实体适配器操作中避免连续执行会改变状态类型的操作
3. 如果自定义适配器，确保正确处理Immer的draft状态

总结

这个案例展示了Redux Toolkit内部如何结合Immer实现不可变状态管理，以及在边界条件下可能出现的问题。通过理解实体适配器的工作原理和Immer的限制，开发者可以更好地避免这类问题，并编写更健壮的Redux代码。