uniapp uncaught typeerror: uni.getstoragesync is not a function 怎么解决？似乎与webview有关

在使用uniapp开发时遇到报错：“uniapp uncaught typeerror: uni.getstoragesync is not a function”，这个问题似乎与webview有关。在H5端运行正常，但在App端的webview中调用uni.getStorageSync方法时提示该函数不存在。请问这是什么原因导致的？该如何解决？需要检查哪些配置或兼容性问题？

2 回复

这个错误通常是因为在Webview环境中调用了uni.getStorageSync方法。解决方法：

  1. 检查是否在Webview页面中调用，如果是，改用localStorage
  2. 添加环境判断：
if(typeof uni !== 'undefined' && uni.getStorageSync) {
  // 使用uni方法
} else {
  // 使用localStorage
}

这个错误通常是因为在 Webview 环境中调用了 UniApp 的 API，但 Webview 本身不支持 uni.getStorageSync 方法。以下是解决方案：

  1. 检查运行环境
    在调用 uni.getStorageSync 前，先判断是否在 UniApp 环境中：

    if (typeof uni !== 'undefined' && uni.getStorageSync) {
  let data = uni.getStorageSync('key');
} else {
  // Webview 环境处理：通过 URL 参数或 postMessage 传递数据
}

  2. Webview 数据传递方案
    如果是通过 Webview 加载的页面，改用以下方式与父应用通信：

    // Webview 页面中
uni.postMessage({ data: { type: 'getStorage', key: 'yourKey' } });

// UniApp 页面的 onLoad 中监听
onLoad(options) {
  const webview = this.$scope.$getAppWebview();
  webview.addEventListener('message', (e) => {
    if (e.data.type === 'getStorage') {
      const value = uni.getStorageSync(e.data.key);
      // 将值传回 Webview（示例：调用 Webview 内全局函数）
      webview.evalJS(`window.setStorageValue(${JSON.stringify(value)})`);
    }
  });
}

  3. 替代存储方案
    在 Webview 中直接使用原生 localStorage：

    // 统一存储方法封装
const getStorage = (key) => {
  if (typeof uni !== 'undefined') {
    return uni.getStorageSync(key);
  } else {
    return localStorage.getItem(key);
  }
}

  4. 排查引入问题
    确保在 main.js 中正确引入了 UniApp 框架，且没有编译异常。

优先推荐方案1和3，通过环境判断实现兼容。若问题持续，请检查 HBuilderX 版本并尝试更新至最新稳定版。

回到顶部