概述

Supabase 是一个集成了 Postgres 数据库和现代化开发工具的强大平台，可显著简化后端开发流程。虽然官方推荐使用 Supabase 客户端进行数据库交互，但掌握直接数据库连接的方法能够提供更大的灵活性和扩展性。本文探讨直接数据库连接的适用场景、配置方法及其在不同项目环境中的影响，帮助开发者进一步提升应用的能力与性能。

直接数据库连接

注意：直接数据库连接需具备额外的专业知识。本书示例项目中仍将使用 Supabase 客户端。

Supabase 本质上是一个以 Postgres 数据库为核心，并围绕其构建了一系列扩展服务的平台。因此，用户也可以选择直接访问底层数据库。

为什么需要直接连接？

许多平台为简化开发而限制了对底层数据库的直接访问，以避免误操作导致的数据风险。然而，Supabase 允许用户在受控环境下直接访问数据库，从而支持更多高级功能，例如：

• 使用扩展库（如 Sequelize、Drizzle 或 pg_dump）

• 实现自定义的数据库扩展与集成

如何建立连接？

在 Supabase 项目仪表板（Studio）的“项目设置 → 数据库”部分可以找到数据库连接字符串。对于本地实例，可通过以下命令获取：

• 运行 npx supabase start 后，终端将显示连接信息；

• 或通过 npx supabase status 查看运行中实例的连接信息。

连接字符串格式通常为：

text

postgresql://postgres:postgres@localhost:54322/postgres

测试连接的几种方式：

1. 最小化测试（使用完整连接字符串）：

   bash

   psql 'postgresql://postgres:postgres@localhost:54322/postgres'

2. 安全连接（避免密码明文显示）：

   bash

   psql -h localhost -p 54322 -d postgres -U postgres

3. 详细参数形式：

   bash

   psql --host=localhost --port=54322 --dbname=postgres --username=postgres

注意：直接操作数据库存在一定风险，建议仅在明确操作后果的情况下进行。

---

在 TypeScript 中使用 Supabase

虽然本书主要基于 JavaScript，但 Supabase 对 TypeScript 提供了开箱即用的支持，能够通过类型提示和自动补全显著提升开发效率。

生成类型定义文件

根据项目环境的不同，生成 TypeScript 类型文件（supabase.ts）的方法如下：

1. 基于 Supabase.com 项目：

bash

npx supabase login
npx supabase gen types typescript --schema public --project-id YOUR_PROJECT_ID > supabase.ts

2. 本地实例：

bash

npx supabase gen types typescript --schema public --local > supabase.ts

3. 自托管或第三方托管实例：

bash

npx supabase gen types typescript --schema public --db-url postgresql://USER:PASSWORD@DB_HOST:PORT/postgres > supabase.ts

应用类型到客户端

将生成的类型导入并传递给 Supabase 客户端，即可实现完全类型安全的操作：

typescript

import type { Database } from './supabase';

export const getSupabaseReqResClient = ({ req, res }) => {
  return createServerClient<Database>(...);
};

若数据库结构发生变更，只需重新生成类型文件即可保持同步。

---

在其他框架中集成 Supabase

Supabase 不依赖于特定框架，基于 RESTful API 的设计使其能够与多种语言和框架无缝集成。

Nuxt 3

1. 安装官方模块：

   bash

   npm install @nuxtjs/supabase

2. 配置 Nuxt 配置文件：

   javascript

   export default defineNuxtConfig({
     modules: ['@nuxtjs/supabase']
   });

3. 在组件中使用：

   vue

   <script setup lang="ts">
   import type { Database } from '~/supabase';
   const client = useSupabaseClient<Database>();
   </script>

Python

1. 安装必要的包：

   bash

   pip install supabase python-dotenv

2. 创建环境变量文件（.env），包含 SUPABASE_URL 和 SUPABASE_ANON_KEY；

3. 初始化客户端：

   python

   import os
   from dotenv import load_dotenv
   from supabase import create_client, Client
   
   load_dotenv()
   supabase_url = os.getenv("SUPABASE_URL")
   supabase_key = os.getenv("SUPABASE_ANON_KEY")
   supabase: Client = create_client(supabase_url, supabase_key)

4. 在项目中导入使用。

提示：Supabase 社区对 JavaScript 生态的支持最为活跃，但也提供了多种其他语言的客户端库（如 Flutter、C#、Swift、Kotlin等）。如无官方客户端，也可通过 REST API 或直接数据库连接实现集成。

---

总结

本文介绍了直接连接 Supabase 数据库的方法及其适用场景，强调了在灵活性和控制力上的优势。同时，详细说明了如何通过 TypeScript 增强类型安全，以及在不同框架（如 Nuxt 和 Python）中集成 Supabase 的技术细节。掌握这些高级功能后，开发者能够更充分地利用 Supabase 的潜力，无论是通过官方客户端还是直接数据库交互，都能构建出更强大、更可靠的应用。