Supabase Storage 项目常见问题解决方案-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00909/article/details/144416325

Supabase Storage 项目常见问题解决方案

storage S3 compatible object storage service that stores metadata in Postgres 项目地址: https://gitcode.com/gh_mirrors/st/storage

项目基础介绍

Supabase Storage 是一个与 S3 兼容的对象存储服务，它将元数据存储在 Postgres 数据库中。该项目的主要目标是提供一个轻量级、可扩展的对象存储解决方案，支持多种协议（如 HTTP、TUS、S3），并且通过 Postgres 的行级安全策略来管理授权规则。

该项目的主要编程语言是 TypeScript，并且使用了 Node.js 作为运行环境。此外，项目还依赖于 Postgres 数据库来存储元数据。

新手使用项目时的注意事项及解决方案

1. 环境变量配置问题

问题描述：
新手在启动项目时，可能会遇到环境变量配置不正确的问题，导致项目无法正常运行。

解决步骤：

复制项目根目录下的 .env.sample 文件，并将其重命名为 .env。
复制项目根目录下的 .env.test.sample 文件，并将其重命名为 .env.test。
根据项目文档中的说明，修改 .env 和 .env.test 文件中的配置项，确保配置正确。
运行以下命令启动项目：
```
npm run infra:restart
npm run dev
```

2. 数据库连接问题

问题描述：
新手在启动项目时，可能会遇到数据库连接失败的问题，通常是由于 Postgres 数据库未正确配置或未启动。

解决步骤：

确保本地 Postgres 数据库已启动，并且可以通过 psql 或其他工具连接到数据库。
检查 .env 文件中的数据库连接配置，确保 DATABASE_URL 指向正确的数据库地址。
如果使用 Docker 启动数据库，确保 Docker 容器已正确运行，并且可以通过 docker ps 命令查看容器状态。
运行以下命令重新启动数据库和项目：
```
npm run infra:restart
npm run dev
```

3. API 请求授权问题

问题描述：
新手在使用项目提供的 API 时，可能会遇到授权失败的问题，通常是由于请求头中缺少或错误的授权令牌。

解决步骤：

确保在请求头中包含正确的 Authorization 字段，并且令牌格式正确。

使用以下命令插入一个名为 avatars 的 bucket，并获取 bucket 列表：

# 插入一个 bucket 名为 avatars
curl --location --request POST 'http://localhost:5000/bucket' \
--header 'Authorization: Bearer <your_token>' \
--header 'Content-Type: application/json' \
--data-raw '[ "name": "avatars" ]'

# 获取 buckets
curl --location --request GET 'http://localhost:5000/bucket' \
--header 'Authorization: Bearer <your_token>'