Next.js应用中Supabase更新调用耗时远超直接SQL查询的原因

我正在开发一个采用Supabase作为后端数据库的Next.js应用，遇到了性能问题：通过Next.js执行数据库更新操作的耗时，远高于直接在数据库中运行等效SQL查询的耗时。

代码示例如下：

await client
  .from(TABLE)
  .update({ test: updatedTest })
  .match({ id })
  .throwOnError();

环境版本：

• Next.js Version: ^14.2.3
• Supabase: 1.50.4
• Supabase/supabase-js: ^2.20.0

请问为何直接SQL查询与Next.js中Supabase客户端调用的执行耗时存在显著差异？

可能的原因分析 #

• 网络链路差异：直接在数据库端执行SQL是本地或内网级别的调用，没有跨网络的传输开销。而Next.js通过supabase-js调用时，需要经过公网HTTP/HTTPS请求，包含DNS解析、TCP握手、TLS加密、请求/响应传输等多个环节，这些网络步骤会带来明显的延迟累加。
• SDK的额外处理逻辑：supabase-js SDK在发送请求前会做参数校验、API请求格式封装，接收响应后还要解析JSON、处理错误捕获（比如throwOnError()的逻辑判断），这些客户端侧的额外处理流程会增加整体耗时，直接SQL执行则没有这些环节。
• Supabase网关层的中间处理：Supabase的API网关会对每个请求做身份验证、RLS（行级安全）规则校验、请求路由转发等操作，这些中间步骤都会产生额外延迟。而直接连接数据库执行SQL时，通常跳过了网关层的这些校验流程。
• Next.js环境的额外开销：如果在客户端组件中调用Supabase，可能受浏览器环境的请求限制影响；如果在服务端组件或API路由中调用，若存在每次请求重新初始化Supabase客户端的情况，也会增加初始化开销。直接SQL则是直接建立数据库连接执行，无此类额外开销。
• SQL执行计划的细微差异：虽然你认为是等效SQL，但supabase-js自动生成的SQL可能和你手动编写的有细节差异（比如参数绑定方式、字段顺序），可能导致数据库生成不同的执行计划。可以通过Supabase控制台的查询日志查看实际执行的SQL，对比和手动SQL的区别来验证这一点。

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