React/Redux异步开发中localStorage未就绪引发JSON解析报错
问题现象
- 触发场景:站点登录流程中,localStorage尚未完成初始化写入,无法正常获取本地存储的用户数据,页面刷新后该问题会自动消失
- 运行时报错:
Unhandled Rejection (SyntaxError): Unexpected token u in JSON at position 0 - 报错触发代码行:
const userData = await userDataGetter();
原有相关代码
Redux Thunk 业务逻辑
export function setBalanseFetch(){ return async dispatch => { const userData = await userDataGetter(); const userID = await userData.userId; try{ const respone = await axios.post('/api/profile', {userID}) const json = await respone["data"]; const FetchBalanse = json.items[0].balanse; dispatch( {type: FETCH_BALANSE, payload: Number(FetchBalanse)}) }catch(e){ console.log(`Axios spend balanse request failed: ${e}`); } } }
原userDataGetter实现
async function userDataGetter(){ const userData = await JSON.parse(localStorage.userData); return userData; } export default userDataGetter
问题根因
Unexpected token u in JSON at position 0是前端JSON解析的经典报错,触发逻辑非常直接:
- 当
localStorage.userData字段不存在时,通过点属性读取的返回值是undefined,JSON.parse会把入参隐式转为字符串"undefined",解析到第0位的u字符时直接抛出语法错误 - 原
userDataGetter没有任何空值兜底,硬加的async/await完全没有实际作用(localStorage读写本身是同步操作),抛出的错误没有被本地捕获,最终形成未处理的Promise拒绝 - Thunk逻辑把
userDataGetter的调用放在了try-catch块外部,根本覆盖不了这一步的异常,直接把错误暴露到全局
修正方案
重构
userDataGetter方法,增加空值兜底,移除无意义的async标记function userDataGetter(){ // 使用getItem读取,字段不存在时返回null,避免拿到undefined const rawUserData = localStorage.getItem('userData'); // 空值判断,避免直接解析空内容 if(!rawUserData) return null; try{ return JSON.parse(rawUserData); }catch(e){ // 本地存储内容异常时兜底返回,不中断业务流程 console.warn('本地用户数据解析失败', e); return null; } } export default userDataGetter调整Thunk内部的逻辑结构,把用户数据获取步骤纳入异常捕获范围,增加空值判断避免无效接口请求
export function setBalanseFetch(){ return async dispatch => { try{ // 将所有异步/读取逻辑纳入try块,覆盖全流程异常 const userData = userDataGetter(); // 空值判断,无有效用户ID时终止流程 if(!userData?.userId) { console.warn('未获取到有效用户ID,终止余额拉取'); return; } const userID = userData.userId; const respone = await axios.post('/api/profile', {userID}) const json = respone.data; const FetchBalanse = json.items[0].balanse; dispatch( {type: FETCH_BALANSE, payload: Number(FetchBalanse)}) }catch(e){ console.log(`余额拉取请求失败: ${e}`); } } }登录流程写入localStorage时增加格式校验,确保写入的是合法JSON字符串,从源头减少读取解析异常的概率。
内容的提问来源于stack exchange,提问作者Cooler-cpu
相关产品推荐
相关产品推荐

