Redux Toolkit 2.2.0 版本中内部类型导出的变更分析

背景概述

在 Redux Toolkit 2.2.0 版本更新后，一些开发者发现之前可以正常使用的内部类型（如 MaybeDrafted 和 PatchCollection）无法再从 @reduxjs/toolkit/dist/query/core/buildThunks 路径导入。这些类型主要用于处理 RTK Query 中的缓存更新操作。

技术细节解析

原有使用方式

开发者原先通过以下方式导入这些内部类型：

import {
    MaybeDrafted,
    PatchCollection,
} from "@reduxjs/toolkit/dist/query/core/buildThunks";

这些类型主要用于处理 RTK Query 的缓存更新场景，特别是在使用 api.util.updateQueryData 方法时，用于生成补丁(patch)操作。

官方建议

Redux Toolkit 团队明确指出，任何从 /dist/ 路径导入的内容都应被视为内部实现细节，可能会在不通知的情况下发生变化。官方推荐的公共入口点包括：

• @reduxjs/toolkit
• @reduxjs/toolkit/react
• @reduxjs/toolkit/query
• @reduxjs/toolkit/query/react

替代方案

对于需要使用这些类型的场景，开发者可以采用以下替代方案：

1. 使用 TypeScript 类型推断：

   // 替代 PatchCollection
   type MyPatchCollection = Array<ReturnType<typeof api.util.updateQueryData>>;
   

2. 使用 Immer 提供的类型：

   • Draft 类型可以直接从 Redux Toolkit 导入（已被重新导出）
   • Patch 类型可以从 immer 库直接导入

最佳实践建议

1. 避免依赖内部路径：始终优先使用官方文档中明确导出的公共 API。

2. 类型安全处理缓存更新：当需要处理 RTK Query 的缓存更新时，可以通过以下方式确保类型安全：

   const updatePatches = (args: SomeArgs) => {
     return api.util.updateQueryData('endpointName', args, (draft) => {
       // 直接操作 draft
     });
   };
   

3. 类型推导优先：在 TypeScript 中，尽可能利用类型推导而不是显式类型声明，这可以减少对特定类型的依赖。

总结

Redux Toolkit 2.2.0 版本中对内部类型的访问限制是一个合理的变更，旨在维护库的稳定性和可维护性。开发者应该调整代码，使用公共 API 或类型推导来替代原先对内部类型的依赖。这种变更虽然短期内可能需要一些代码调整，但从长期来看有助于提高应用的稳定性和可维护性。

对于高级用例，可以考虑将复杂的缓存更新逻辑封装为工具函数，并通过类型参数或推导来保持类型安全，而不是直接依赖库的内部实现细节。