You need to enable JavaScript to run this app. React/Redux异步开发中localStorage未就绪引发JSON解析报错
优惠活动
大模型
产品
解决方案
定价
更多

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块外部,根本覆盖不了这一步的异常,直接把错误暴露到全局

修正方案
  1. 重构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
    
  2. 调整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}`);
        }
      }
    }
    
  3. 登录流程写入localStorage时增加格式校验,确保写入的是合法JSON字符串,从源头减少读取解析异常的概率。


内容的提问来源于stack exchange,提问作者Cooler-cpu

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.07 16:15:07