RTK Query如何忽略动态参数将数据存入指定状态路径？

RTK Query 默认会将所有传入的 query 参数作为缓存键的生成依据，所以不同的 signature 会被识别为不同请求，生成独立的缓存条目。要让它忽略 signature、仅以 name 作为缓存标识，你可以通过自定义 serializeQueryArgs 方法来实现。

具体修改方式 #

在目标 endpoint 的配置中添加 serializeQueryArgs，只基于 name 参数生成缓存键：

export const restApi = createApi({
  reducerPath: "restApi",
  baseQuery: fetchBaseQuery({ baseUrl: 'https://pokeapi.co/api/v2/pokemon/' }),
  endpoints: (builder) => ({
    getPokemonByName: builder.query({
      query: ({ name, signature }) => `${name}?signature=${signature}`,
      // 自定义缓存键生成逻辑，仅使用name参数
      serializeQueryArgs: ({ queryArgs }) => {
        return JSON.stringify({ name: queryArgs.name });
      },
      // 可选配置：如果需要每次传入新signature时强制刷新缓存
      // refetchOnMountOrArgChange: true,
      // 或者设置缓存过期时间为0，立即清理未使用的缓存
      // keepUnusedDataFor: 0,
    }),
  }),
});

原理说明 #

serializeQueryArgs 是 RTK Query 用来判断两个请求是否属于同一个缓存项的核心函数。这里我们只序列化 name 参数，无论 signature 如何变化，都会被判定为同一个请求，后续请求会直接更新对应 name 的缓存状态，而不会创建新的缓存条目。

如果需要全局统一处理这类忽略特定参数的场景，也可以在 createApi 的根级别配置 serializeQueryArgs，但这样会影响所有 endpoint，建议按需在单个 endpoint 配置更灵活。

内容的提问来源于stack exchange，提问作者Expl0de