React Native调用AsyncStorage的setItem报undefined非对象错误

这个报错的核心触发逻辑非常直接：你在代码中导入的AsyncStorage本身就是undefined，调用其setItem属性时，自然会抛出「无法在undefined对象上执行属性访问」的类型错误。
常见的具体触发场景包括：

• 导入的依赖包已废弃、导入方式不匹配，无法拿到有效的AsyncStorage实例
• 原生模块未完成正确链接，JS层拿到的导出值是空值
• 项目路径别名配置错误，把AsyncStorage的导入指向了空的本地占位文件

1. 修正依赖安装与导入逻辑 #

• 原@react-native-community/async-storage包已经停止维护，官方维护版本已迁移到新包名@react-native-async-storage/async-storage，如果仍从旧包名做解构导入，拿到的导出值必然是undefined
• 替换原有错误的导入写法：
  错误写法：

  import { AsyncStorage } from '@react-native-community/async-storage'
  

  正确写法（新包采用默认导出，不支持解构导入）：

  import AsyncStorage from '@react-native-async-storage/async-storage'
  

• 导入完成后建议先在应用入口打印验证：console.log(AsyncStorage)，确认打印的对象上存在setItem方法，而非undefined值

2. 完成原生模块的正确链接 #

• RN 0.6及以上版本虽然支持自动链接，但仅热更新JS代码无法让原生模块生效，必须重新执行npx react-native run-android或npx react-native run-ios重新编译并安装原生包
• RN 0.6以下的老项目，需要手动完成iOS端Pod依赖安装、Android端模块注册的全流程，确保原生层的AsyncStorage模块能被JS层正常调用

3. 修正业务代码中的潜在异常 #

• 对齐addStack函数的参数传值：当前addStack函数定义需要6个入参，但调用时多传入了1个check状态值，需删除多余传参避免逻辑异常
• 修正propTypes的类型校验规则：当前传入的stackID是moment格式化的日期字符串，但原propTypes声明为number类型，需改成PropTypes.string.isRequired匹配实际数据结构，避免类型校验拦截
• 写入逻辑增加兜底判断，避免模块加载异常时直接触发应用崩溃：

  if (AsyncStorage?.setItem) {
    AsyncStorage.setItem('stack', JSON.stringify(stackData)).catch(err => alert(err.message))
  } else {
    alert('本地存储模块加载异常，请重启应用后重试')
  }
  

内容的提问来源于stack exchange，提问作者bash.ruv