Supabase Storage下载文件返回undefined，如何正确获取文件？

排查步骤及解决方案 #

1. 检查存储桶与文件权限 #

Supabase存储桶默认私有，即便文件存在，权限配置错误也会导致下载返回undefined：

• 进入Supabase控制台的Storage模块，找到bulk-uploads存储桶：
  • 若需公开访问，可将存储桶设置为公共；若保持私有，需确保当前用户拥有该文件的读取权限。
  • 可通过SQL语句给认证用户授予读取权限：

    insert into storage.policies (name, bucket_name, action, role, using)
    values ('Allow authenticated users to read bulk-uploads files', 'bulk-uploads', 'select', 'authenticated', 'true');
    

2. 验证文件路径准确性 #

文件路径csv/218c1ad526a2e9d2cbacd9e49587c2e777a5bdd71675166133663.csv需完全匹配存储桶内实际路径：

• 注意路径区分大小写，检查是否存在大小写错误
• 确认斜杠是否正确（download方法的路径无需开头斜杠）

3. 修正文件解析逻辑 #

Supabase download方法成功返回的是Blob对象，直接传给Papa.parse无法正确解析，且需增加空值判断：

const { data: file, error } = await supabase.storage.from('bulk-uploads').download('csv/218c1ad526a2e9d2cbacd9e49587c2e777a5bdd71675166133663.csv')

if (error) {
  console.error('下载错误:', error.message);
  throw error;
}

if (!file) {
  console.error('未获取到文件，请检查权限或路径');
  return;
}

console.log("File Downloaded", file)
// 先将Blob转为文本再解析
const fileText = await file.text();
let filedata = Papa.parse(fileText).data;

4. 确认用户认证状态 #

若存储桶为私有访问，需确保代码执行时用户已完成认证：

const { data: { user } } = await supabase.auth.getUser();
if (!user) {
  console.error('用户未认证，无法访问私有存储桶');
  // 此处可添加用户登录逻辑
}

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