如何为<App/>提供客户端与服务端渲染逻辑不同、App及thunk均需使用的数据的最佳实践
入口层预加载不可变数据的通用最佳实践
你当前遇到的核心矛盾,本质是把仅在入口生成、运行期不可变的纯上下文数据,和需要随应用交互更新、纳入状态管理的可变业务数据做了不必要的强绑定,下面两种方案可以从根本上解决你的痛点,不需要额外写冗余的占位逻辑。
方案一:通过Redux原生能力注入上下文,不侵入状态树结构
这是最贴合这类场景的官方推荐实现,完全不需要为预加载数据创建单独的Slice、也不需要维护占位的initialState:
- 入口层生成不可变数据后,在创建store时,直接将数据作为thunk中间件的
extraArgument参数注入。这个参数是Redux Toolkit原生支持的能力,所有thunk都可以无阻碍访问,完全不需要依赖state读取:// CSR 入口 index.tsx const COUNTRY = getCountry(window.location); const store = configureStore({ reducer: rootReducer, middleware: (getDefaultMiddleware) => getDefaultMiddleware({ thunk: { // 把所有预加载的不可变数据直接透传给thunk extraArgument: { COUNTRY } } }) })// SSR 入口 ssrApp.tsx 逻辑完全统一 const COUNTRY = getCountry(req.hostname); // 创建store时传入相同的extra参数即可,无需改动核心逻辑 - Thunk内部直接从参数中读取预加载数据,不需要读取state:
export const fetchUserInfo = createAsyncThunk( 'user/fetchInfo', async (_, { extra }) => { // 直接拿到预加载的COUNTRY值 const { COUNTRY } = extra as { COUNTRY: string }; return fetch(`/api/user?region=${COUNTRY}`) } ) - 组件层不需要额外做状态绑定,直接在入口渲染时把同一份不可变数据通过Context透传即可,因为数据永远不会变动,不存在同步问题:
render( <PreloadedDataContext.Provider value={{ COUNTRY }}> <Provider store={store}> <App /> </Provider> </PreloadedDataContext.Provider> )
这个方案的优势:
- 完全不需要把这类无交互更新的不可变数据塞进Redux状态树,避免状态树冗余
- 没有任何需要维护的占位初始值逻辑
- 天然兼容CSR、SSR双入口场景,逻辑统一
方案二:单源只读状态代理,无需写冗余Slice逻辑
如果你希望所有预加载数据统一从Redux状态树读取,不想额外透传Context,也不需要为这部分数据维护单独的Slice和占位initialState,可以用纯代理reducer实现:
- 因为这类数据永远不会被任何action修改,根本不需要用
createSlice创建带reducer逻辑的切片,直接写一个纯只读的代理reducer,把预加载的状态挂到根状态树上:// 这个reducer永远返回传入的预加载状态,不处理任何action const preloadedProxyReducer = (state = {}) => state; const rootReducer = combineReducers({ // 其他正常的业务可变状态切片 user: userSlice.reducer, product: productSlice.reducer, // 预加载的只读状态块,无任何更新逻辑 PRELOADED: preloadedProxyReducer }) - 创建store时正常通过
preloadedState注入入口层生成的COUNTRY数据即可:const store = configureStore({ reducer: rootReducer, preloadedState: { PRELOADED: { COUNTRY } } })
这个写法完全绕开了你之前遇到的“必须写占位initialState、必须实现reducer逻辑”的问题,因为RTK对普通纯函数reducer没有强制的Slice格式要求。后续不管是组件通过useSelector(state => state.PRELOADED.COUNTRY)读数据,还是thunk里通过getState().PRELOADED.COUNTRY读数据,都是同一份来源,不存在数据不一致的问题。
常见避坑提示
- 不要为了图省事把预加载数据直接挂到全局window对象上,SSR场景下很容易出现不同请求间的数据串扰,也没有统一的类型约束
- 不要为无更新逻辑的预加载数据创建带action的Slice,会让这部分纯上下文数据被误纳入可触发状态更新的逻辑流,增加不必要的心智负担
内容的提问来源于stack exchange,提问作者cbdeveloper
相关产品推荐
相关产品推荐

