能否为Redux Toolkit Query API切片中所有端点统一添加缓存标签？

现有实现与问题 #

我有一个API，请求头包含动态参数region，参数值随用户操作变化。因为它不属于URL/请求参数，我通过serializeQueryArgs把它加入缓存键，避免不同region的缓存混淆：

serializeQueryArgs: args => {
    const region = localStorage.getItem('region');

    return `${region}_${defaultSerializeQueryArgs(args)}`;
}

但这种方式无法在切换region时自动触发重新请求。

后来尝试用缓存标签解决：先在API定义中添加标签类型，切换region时使标签失效：

export const apiSlice = createApi({
    tagTypes: ['region'],
    // 其他配置
});

const changeRegion = region => {
    dispatch(setRegion(region));
    dispatch(apiSlice.util.invalidateTags(['region']));
}

这个方案有效，但必须给每个端点手动配置providesTags: ['region']。我有数百个端点，逐个配置效率极低，还容易遗漏新端点。想找一种一次性给所有端点添加该标签的方法，猜测enhanceEndpoints可以实现，但不清楚具体用法。理想的简洁写法类似：

export const apiSlice = createApi({
    tagTypes: ['region']
})
.providesTags(['region']);

另外试过apiSlice.util.resetApiSlice，不仅没触发重新请求，还导致站点白屏，只能刷新恢复。

解决方案 #

使用enhanceEndpoints可以批量修改所有端点的配置，自动为它们添加region标签，具体代码如下：

方法一：遍历合并端点配置 #

export const apiSlice = createApi({
    tagTypes: ['region'],
    // 你的baseQuery、endpoints等原有配置
})
.enhanceEndpoints({
    endpoints: (originalEndpoints) => {
        const enhancedEndpoints = {};
        for (const [name, endpoint] of Object.entries(originalEndpoints)) {
            enhancedEndpoints[name] = {
                ...endpoint,
                // 保留端点原有providesTags，同时添加'region'标签
                providesTags: Array.isArray(endpoint.providesTags)
                    ? [...endpoint.providesTags, 'region']
                    : ['region']
            };
        }
        return enhancedEndpoints;
    }
});

方法二：用Object.fromEntries简化写法 #

export const apiSlice = createApi({
    tagTypes: ['region'],
    // 原有配置
})
.enhanceEndpoints({
    endpoints: (originalEndpoints) => ({
        ...originalEndpoints,
        ...Object.fromEntries(
            Object.entries(originalEndpoints).map(([key, endpoint]) => [
                key,
                {
                    ...endpoint,
                    providesTags: [...(endpoint.providesTags || []), 'region']
                }
            ])
        )
    })
});

这样所有端点都会自动带上region标签，切换region时调用invalidateTags(['region'])就能触发所有相关端点的重新请求，无需逐个配置。

关于resetApiSlice导致白屏的问题：这个方法会清空整个API的缓存和状态，如果组件依赖缓存数据，清空后可能因数据缺失引发渲染错误。相比之下，标签失效的方式更精准，不会影响整个应用状态。

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