Node.js项目未使用Storage却触发存储访问权限错误排查求助

• 排查依赖包的隐性调用
  你自己没写storage相关代码，但依赖包可能偷偷用了。在项目根目录执行搜索命令，找出调用存储的依赖：

  • Linux/macOS：grep -r "localStorage\|sessionStorage" node_modules/
  • Windows：findstr /s /i "localStorage sessionStorage" node_modules\*
    搜索结果会显示具体的文件和代码行，定位到对应的依赖包后，查看它的文档或源码，确认是否需要配置权限，或者是否有替代方案。

• 区分错误发生的环境
  这个错误大概率是前端浏览器抛出的（Node.js原生环境没有localStorage），先看错误栈的调用路径：

  • 如果是前端文件路径（比如public/js/app.js），说明是前端代码或前端依赖触发的；
  • 如果是Node.js后端文件，那可能是用了模拟localStorage的包（比如node-localstorage），这类包在某些环境下可能权限受限。

• 给存储操作加调用栈追踪
  如果是前端问题，在浏览器控制台执行这段代码，下次触发错误时会打印完整调用栈，直接找到调用源头：

  // 追踪localStorage.setItem
  const originalSetItem = localStorage.setItem;
  localStorage.setItem = function(key, value) {
    console.trace('localStorage调用追踪：');
    originalSetItem.apply(this, arguments);
  };
  
  // 同时追踪getItem和removeItem，可选
  const originalGetItem = localStorage.getItem;
  localStorage.getItem = function(key) {
    console.trace('localStorage调用追踪：');
    return originalGetItem.apply(this, arguments);
  };
  

  如果是Node.js环境用了模拟存储，找到对应的模块（比如node-localstorage），在项目入口文件里加类似的追踪代码。

• 检查环境和依赖变化
  既然之前运行正常，突然出问题，优先排查最近的变动：

  • 看package.json或锁文件（package-lock.json/yarn.lock），是否有依赖包自动更新；
  • 检查Node.js版本、浏览器版本是否升级；
  • 确认项目运行的上下文是否变化（比如从普通网页变成了iframe、Web Worker，或者浏览器隐私设置禁用了存储）。

• 排查第三方SDK/服务
  如果你集成了第三方服务（比如登录、统计、支付SDK），这些工具往往会在初始化或运行时调用存储。逐一排查最近新增或更新的第三方服务，暂时禁用它们看错误是否消失，定位到具体的SDK后查看文档调整配置。

内容的提问来源于stack exchange，提问作者jvanheijzen