React Native中AsyncStorage在release包失效但debug模式正常问题求助

开发者阿泽

2026-10-2

问题根因

核心是异步时序问题：你未等待AsyncStorage.setItem执行完成就触发了读取逻辑，debug模式下JS执行速度慢，存储操作刚好在读取前完成，release模式下JS执行效率提升，存储未完成就读取，自然拿到空值。
读取逻辑缺少状态判断：触发getUserData时未判断getData是否已被赋值，初始值为undefined时访问getData.email直接报错，后续逻辑中断。
你使用的@react-native-async-storage/async-storage@1.15.5存在已知的Android release模式下写入落盘不及时的原生层bug。

修复方案

修复存储逻辑的异步等待，优先使用multiSet批量写入保证原子性，写入完成后再执行页面跳转等后续操作：

fetch('',{
// 其他代码省略
.then((response) => response.json())
      .then(async (responseJson) => {
     // 批量写入保证所有数据同时落盘，等待操作完成再继续
     await AsyncStorage.multiSet([
        ['user_token', JSON.stringify(responseJson.token)],
        ['user_id', JSON.stringify(responseJson.data)],
        ['login_type', 'LocalLogin']
     ]);
     // 写入完成后再执行页面跳转/状态更新逻辑
     navigation.replace('你的目标页面');
   });
});

修复读取逻辑的时序和空值判断问题：

// 明确初始值为null
const [getData, setGetData] = useState(null);

const initializeData = async() => {
    const userId = await AsyncStorage.getItem('user_id');
    if(userId) {
      setGetData(JSON.parse(userId));
    }
  }

useEffect(() => {
  initializeData();
},[]);

// 依赖添加getData，且仅在getData有值时调用接口
useEffect(() => {
  if (!getData) return;
  getUserData();
},[navigation,isFocused, getData]);

const getUserData = async() => {
  // 增加空值防御
  if (!getData?.email) return;
  var formBody = JSON.stringify({email: getData.email});
  // 其他代码省略
}