ngrx-store-localstorage同步异常：状态与localStorage不同步

我之前用这个包的时候也踩过一模一样的坑，结合你的情况，给你几个具体的排查和解决方向：

1. 确认同步的keys路径是否完全匹配 #

首先得搞清楚你的store状态结构：如果你的root reducer是通过combineReducers({ auth: authReducer })组合的，那要同步的分支名是字符串'auth'，不是直接写reducers.auth（这是代码里的变量，不是状态树的路径）。

如果只需要同步auth下的token字段，也可以更精准地配置：

localStorageSync({
  keys: [{ auth: ['token'] }], // 仅同步auth分支下的token字段
  rehydrate: true
})

2. 检查Reducer是否返回了不可变的新状态 #

这是最容易忽略的关键！ngrx依赖状态的不可变性来检测变化，如果你的reducer在处理登录action时修改了原状态对象，而不是返回新对象，ngrx-store-localstorage会检测不到状态更新，自然不会同步到localStorage。

❌ 错误写法（修改原状态）：

case AuthActionTypes.LoginSuccess:
  state.token = action.payload.token;
  return state;

✅ 正确写法（返回新状态对象）：

case AuthActionTypes.LoginSuccess:
  return {
    ...state,
    token: action.payload.token
  };

3. 确认MetaReducer的顺序 #

如果你的项目里有多个metaReducers（比如logger），一定要把localStorageSync放在最后，确保它处理的是经过所有其他metaReducer处理后的最终状态：

export const metaReducers: MetaReducer<State>[] = [
  loggerReducer, // 其他metaReducer先执行
  localStorageSyncReducer // 最后执行同步操作
];

4. 验证状态变化是否真的被触发 #

打开ngrx devtools，找到登录成功的action，查看状态diff：确认auth.token字段确实有从null到目标值的变化，并且状态对象是全新的（不是同一个引用）。如果diff里没有显示token的变化，那问题出在reducer或action的处理上，不是同步插件的问题。

完整配置示例 #

给你一个标准的配置参考，确保每一步都正确：

// app.state.ts
import { ActionReducerMap } from '@ngrx/store';
import { authReducer, AuthState } from './auth/auth.reducer';

export interface AppState {
  auth: AuthState;
}

export const reducers: ActionReducerMap<AppState> = {
  auth: authReducer
};

// app.module.ts
import { NgModule } from '@angular/core';
import { StoreModule } from '@ngrx/store';
import { localStorageSync, LocalStorageSyncConfig } from 'ngrx-store-localstorage';
import { reducers, AppState } from './app.state';

const syncConfig: LocalStorageSyncConfig = {
  keys: ['auth'],
  rehydrate: true
};

export const localStorageSyncMetaReducer = localStorageSync(syncConfig);

@NgModule({
  imports: [
    StoreModule.forRoot(reducers, {
      metaReducers: [localStorageSyncMetaReducer]
    })
  ]
})
export class AppModule { }

按照上面的步骤排查，应该能解决你的同步问题！

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