supabase 不支持传统 sql 的 join 语法，而是通过从关联表（如 `usuario_empresa`）出发，使用嵌套选择（`select()` 中的 `table:column` 语法）实现一对多/多对多关系查询。本文详解如何正确转换三表联查 sql 到 supabase 客户端代码，并避免常见错误。
在 Supabase 中，不存在 .join() 方法——这是导致你报错的根本原因。官方 JavaScript 客户端（@supabase/supabase-js）不提供 .join() 链式调用接口，相关文档中也从未定义该方法。你看到的 AI 推荐代码是错误的，属于对底层 PostgreSQL 能力的误迁移。
✅ 正确做法是：以关系桥接表（usuario_empresa）为查询主表，再通过 Supabase 的 嵌套选择（Nested Select）语法 拉取关联数据。该语法利用 PostgreSQL 的 SELECT ... FROM table, LATERAL (SELECT ...) 底层能力，在客户端以声明式字符串形式表达关联关系。
以下是适配你数据库结构的完整、可运行代码：
const { data, error } = await supabase
.from('usuario_empresa')
.select(`
usuario:usuario_id (
id,
nome,
email,
telefone,
data_nascimento,
cidade_nascimento
),
empresa:empresa_id (
id,
nome,
cnpj,
endereco
)
`);? 关键语法说明：
- usuario:usuario_id 表示：将 usuario_empresa.usuario_id 字段作为外键，关联到 usuario 表，并将结果嵌套在 data[i].usuario 字段下；
- empresa:empresa_id 同理，嵌套在 data[i].empresa 下；
- 括号内为要选取的 usuario 和 empresa 表字段列表（支持别名、函数、甚至嵌套更深的关系）；
- 所有表名均省略 public. 前缀（Supabase 默认访问 public schema，显式加前缀反而会报错）。
? 进阶提示：若 usuario_empresa 表未来增加自增主键 id，且你需要返回它，可直接添加到 select 字符串开头：
.select(` id, // ← 来自 usuario_empresa 表的自身字段 usuario:usuario_id (id, nome, email), empresa:empresa_id (id, nome, cnpj) `)
⚠️ 注意事项：
- 不要尝试 .from('usuario').join(...) —— 该方法根本不存在，TypeScript 会报错，运行时抛出 TypeError: ...join is not a function；
- 确保外键约束已正确创建（你提供的 DDL 已满足，fk_usuario 和 fk_empresa 存在）；
- 若查询返回 null 关系（如某条 usuario_empresa 记录对应 usuario 被删除），Supabase 默认返回 null（符合外键引用完整性），可通过 coalesce 或服务端视图进一步控制；
- 如需过滤（例如只查某用户的所有公司），可在 .select() 前链式调用 .eq('usuario_id', userId)。
总结：Supabase 的关系查询本质是「以关联表为中心 + 声明式嵌套拉取」，而非模拟 SQL JOIN。掌握 table:column (fields...) 这一核心语法，即可优雅、高效、类型安全地实现多表关联，无需复杂封装或自定义 RPC。
