Redux Toolkit 中 createApi 的 invalidationBehavior 选项详解

Redux Toolkit 作为现代 Redux 开发的标配工具，其 RTK Query 模块极大地简化了数据获取和缓存管理。在 RTK 2.0 版本中，新增了一个重要的配置选项 invalidationBehavior，它专门用于控制标签失效时的行为模式。本文将深入解析这个选项的作用机制和使用场景。

invalidationBehavior 的核心作用

invalidationBehavior 选项主要用于调节当调用 invalidateTags 方法时，RTK Query 如何处理已缓存数据的失效逻辑。这个配置项提供了两种不同的行为模式：

1. 立即失效模式（immediate）：这是默认行为，当调用 invalidateTags 时，所有匹配标签的查询会立即标记为无效，并触发可能的重新获取。

2. 延迟失效模式（delayed）：在这种模式下，标记为无效的查询不会立即触发重新获取，而是等到下次组件挂载或手动触发时才会执行。

配置方式与参数说明

在创建 API 服务时，可以通过以下方式配置失效行为：

import { createApi } from '@reduxjs/toolkit/query/react'

const api = createApi({
  // 其他配置...
  invalidationBehavior: 'delayed', // 或 'immediate'
})

使用场景分析

立即失效模式（immediate）

这种模式适合以下场景：

• 需要确保数据严格一致性的应用
• 在数据变更后立即要求获取最新数据的场景
• 小型应用或数据量不大的情况

特点：

• 响应速度快，数据变更后立即更新
• 可能产生较多的网络请求
• 对服务器压力相对较大

延迟失效模式（delayed）

这种模式更适合：

• 大型应用或数据量大的情况
• 需要优化网络请求的场景
• 对实时性要求不高的功能模块

特点：

• 减少不必要的网络请求
• 按需获取数据，优化性能
• 需要开发者更主动地管理数据更新

实际开发建议

1. 默认选择：对于大多数应用，使用默认的 immediate 模式即可满足需求。

2. 性能优化：当发现应用中有大量不必要的重新获取时，可以考虑切换到 delayed 模式。

3. 混合使用：虽然不能针对单个标签设置不同模式，但可以通过创建多个 API 实例来实现不同模块采用不同的失效策略。

4. 注意事项：在 delayed 模式下，需要确保在适当的时候（如路由切换或用户操作）手动触发数据更新，以避免显示过时数据。

内部实现机制

从实现层面看，这个选项主要影响的是 RTK Query 的核心调度器行为。在 immediate 模式下，调度器会立即执行失效检查和可能的重新获取；而在 delayed 模式下，只是标记数据状态，实际获取操作会被推迟。

理解这个选项的工作原理，有助于开发者更好地设计应用的数据流，在数据一致性和性能之间取得平衡。随着 Redux Toolkit 的持续演进，这类细粒度控制选项将帮助开发者构建更高效的前端应用。