调用Supabase Storage API创建Bucket触发行级安全策略错误求助

报错原因：RLS策略限制 #

调用const createBucketRes = await supabase.storage.createBucket('avatars')时出现StorageApiError: new row violates row-level security policy错误，核心原因是Supabase Storage默认RLS策略禁止普通客户端API创建Bucket。

默认状态下，storage.buckets表的RLS规则仅允许Supabase仪表盘（管理员权限）创建Bucket，普通客户端请求没有权限执行该操作。

API创建Bucket的作用 #

这个API并非无用，核心适用场景包括：

• 服务端自动化操作：使用服务角色密钥（service_role）发起请求时，可绕过RLS限制，实现批量、自动化创建Bucket，比如在用户注册流程中自动生成专属存储桶，或在部署脚本中初始化存储结构。
• 自定义RLS后的客户端操作：若修改storage.buckets表的RLS策略，允许特定条件的客户端请求创建Bucket（比如仅认证用户可创建私有Bucket），此时客户端API就能直接完成创建，无需依赖仪表盘手动操作。

参考文档（中文翻译） #

Supabase Storage JavaScript快速入门关键内容 #

Supabase Storage用于存储管理用户生成内容（如图片、视频、文档）。关于创建Bucket的核心说明：

1. 确保已正确初始化包含存储模块的Supabase客户端。
2. 默认仅管理员或使用服务角色密钥的服务端请求可创建Bucket；若需客户端创建，必须修改storage.buckets表的RLS策略。
3. 自定义RLS策略示例（允许认证用户创建Bucket）：
   在Supabase SQL编辑器执行以下代码：

   CREATE POLICY "Authenticated users can create buckets" ON storage.buckets
   FOR INSERT TO authenticated
   WITH CHECK (true);
   

   提示：需根据安全需求调整策略条件，避免权限过度开放。

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