如何基于URL参数编写多表关联的Supabase数据库查询？

首先确认你的表外键已正确配置：

• books.series_id 需设置外键关联 series.id
• books.authors_id 需设置外键关联 authors.id
  Supabase的PostgREST依赖外键识别表间关联，否则无法使用嵌套查询语法。

两种可行的查询写法 #

写法1：从系列表出发，关联书籍与作者 #

这种写法适合确保系列名称唯一的场景，直接定位目标系列后获取其下所有书籍：

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

export async function getServerSideProps(context) {
  const { series } = context.query;
  // 处理参数为空的情况
  if (!series) {
    return { props: { books: [] } };
  }

  // 初始化Supabase客户端（使用服务端密钥确保权限）
  const supabase = createClient(
    process.env.NEXT_PUBLIC_SUPABASE_URL,
    process.env.SUPABASE_SERVICE_ROLE_KEY
  );
  
  try {
    const { data, error } = await supabase
      .from('series')
      .select(`
        series,
        books(id, title, authors(name))
      `)
      .eq('series', series)
      .single(); // 系列名称唯一时用single()获取单个结果

    if (error) throw error;

    // 整理返回数据，扁平化嵌套结构
    const booksWithDetails = data?.books?.map(book => ({
      id: book.id,
      title: book.title,
      series_name: data.series,
      author_name: book.authors?.name
    })) || [];

    return { props: { books: booksWithDetails } };
  } catch (err) {
    console.error('查询失败:', err);
    // 错误时返回空数组避免页面崩溃
    return { props: { books: [] } };
  }
}

写法2：从书籍表出发，过滤关联的系列名称 #

如果需要更灵活的过滤逻辑，可直接从书籍表查询并通过关联表过滤：

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

export async function getServerSideProps(context) {
  const { series } = context.query;
  if (!series) {
    return { props: { books: [] } };
  }

  const supabase = createClient(
    process.env.NEXT_PUBLIC_SUPABASE_URL,
    process.env.SUPABASE_SERVICE_ROLE_KEY
  );
  
  try {
    const { data, error } = await supabase
      .from('books')
      .select(`
        id,
        title,
        series(series),
        authors(name)
      `)
      .eq('series.series', series); // 通过关联的series表过滤名称

    if (error) throw error;

    const booksWithDetails = data?.map(book => ({
      id: book.id,
      title: book.title,
      series_name: book.series?.series,
      author_name: book.authors?.name
    })) || [];

    return { props: { books: booksWithDetails } };
  } catch (err) {
    console.error('查询失败:', err);
    return { props: { books: [] } };
  }
}

关键注意事项 #

1. 系列名称唯一性：如果series.series字段允许重复，需移除single()并调整数据处理逻辑，避免因返回多个系列导致错误。
2. 错误处理：必须捕获error并处理，否则查询失败时会触发500服务器错误。
3. 多作者场景：如果一本书对应多个作者，当前的books.authors_id单外键结构不适用，需新增中间表books_authors（包含book_id和author_id两个外键），并调整查询为authors(name)的嵌套数组。
4. 大小写匹配：如果需要忽略大小写，可将.eq()替换为.ilike()，例如.ilike('series', \%${series}%`)`。

当前你的表结构在单作者场景下是合理的，无需调整。

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