Supabase下载图片报400错误：headers缺少必填authorization属性如何解决？

API 探路者

2026-9-27

问题排查与解决方法

这个400错误是请求Supabase存储服务时未携带要求的Authorization头导致的，可按以下步骤排查修复：

排查步骤

检查supabase客户端初始化配置
确认你项目中初始化supabase的代码同时传入了SUPABASE_URL和SUPABASE_ANON_KEY两个必填参数，没有出现参数漏传、拼写错误的情况。正确初始化示例如下：

import { createClient } from '@supabase/supabase-js'

const supabase = createClient(
  process.env.NEXT_PUBLIC_SUPABASE_URL,
  process.env.NEXT_PUBLIC_SUPABASE_ANON_KEY
)

检查存储桶权限与用户会话状态
如果job-photo存储桶未设置为公开权限，必须在用户登录并生成有效会话后才能调用存储相关接口。如果触发下载方法时用户还未完成登录，就会缺失授权信息。
验证环境变量生效状态
如果是Next.js项目，确认两个supabase环境变量都是NEXT_PUBLIC_前缀，写在项目根目录的.env.local文件中，修改后已经重启过开发服务，变量值可以正常读取。

解决方法

如果你需要job-photo桶内的资源可以无权限访问，直接在Supabase后台将该存储桶设置为公开桶即可，不需要授权头即可正常下载资源。
如果桶需要保留非公开权限，在调用下载方法前先校验用户会话是否存在，会话有效再执行下载逻辑，示例代码如下：

async function downloadImage(path) {
  try {
    // 新增会话校验
    const { data: { session } } = await supabase.auth.getSession()
    if (!session) {
      throw new Error('用户未登录，请先登录后再操作')
    }
    const { data, error } = await supabase.storage
      .from("job-photo")
      .download(`jobphotos/${path}.jpg`);
    if (error) {
      throw error;
    }
    const url = URL.createObjectURL(data);
    setAvatarUrl(url);
  } catch (error) {
    console.log("Error downloading image: ", error.message);
  }
}