Supabase查询表触发TypeError：globalThis.localStorage.getItem未定义

这个报错的核心原因是你的运行环境不存在localStorage（比如Node.js后端、服务器端渲染场景、或者非浏览器环境），而Supabase默认客户端会尝试用localStorage存储用户会话信息，找不到这个API就会抛出该错误。

针对性解决方法 #

• 非浏览器/Node.js后端环境
  初始化Supabase客户端时，显式禁用依赖localStorage的会话持久化配置：

  import { createClient } from '@supabase/supabase-js'
  
  const supabase = createClient(
    '你的Supabase URL',
    '你的匿名密钥',
    {
      auth: {
        storage: null, // 禁用localStorage
        persistSession: false, // 关闭会话持久化
        autoRefreshToken: false,
        detectSessionInUrl: false
      }
    }
  )
  

  如果是服务端需要操作数据，建议使用Supabase的服务端密钥（service_role key），但注意该密钥权限极高，绝对不能暴露给前端。

• SSR/SSG框架场景（如Next.js、Nuxt.js）

  • 区分客户端与服务端代码：仅在客户端组件中初始化并使用Supabase客户端；
  • 使用对应框架的官方Supabase集成工具（比如Next.js用@supabase/auth-helpers-nextjs），这类工具会自动处理环境适配问题。

• 检查代码执行时机
  确保Supabase客户端的初始化和查询操作，只在支持localStorage的浏览器环境中执行，避免在服务器端渲染阶段调用浏览器专属API。

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