Remotion Lambda 客户端在 Supabase Edge Functions 中的轻量化实践

背景介绍

Remotion 是一个基于 React 的框架，允许开发者使用熟悉的 React 语法创建和渲染视频。Remotion Lambda 是其云端渲染服务，而 Supabase Edge Functions 是 Supabase 提供的无服务器函数服务，运行在 Deno 环境中。

问题发现

在将 Remotion Lambda 客户端集成到 Supabase Edge Functions 时，开发者遇到了一个关键限制：Edge Functions 对部署包大小有严格的 20MB 限制，而标准的 Remotion Lambda 客户端包体积达到了约 34.9MB，这直接导致了部署失败。

技术分析

经过深入分析，发现导致包体积过大的主要原因包括：

1. AWS SDK 依赖：Remotion Lambda 客户端内置了完整的 AWS SDK，这是体积最大的部分
2. 渲染器依赖：@remotion/renderer 包包含了大量视频处理逻辑
3. 辅助功能模块：如定价计算、验证等非核心功能

解决方案

Remotion 团队针对这一问题开发了专门的轻量级客户端包 @remotion/lambda-client，其优化策略包括：

1. 模块拆分：将核心功能与非核心功能分离
2. 依赖优化：移除不必要的依赖项
3. 按需加载：只包含最基本的 Lambda 操作功能

实践验证

开发者通过以下代码成功在 Supabase Edge Functions 中部署并运行了 Remotion Lambda 客户端：

import {
  renderMediaOnLambda,
  speculateFunctionName,
} from "npm:@remotion/lambda-client@4.0.265";

Deno.serve(async (req) => {
  const { props } = await req.json();
  try {
    const response = await renderMediaOnLambda({
      serveUrl: "https://remotion-helloworld.vercel.app",
      composition: "HelloWorld",
      codec: "h264",
      region: "eu-central-1",
      functionName: speculateFunctionName({
        memorySizeInMb: 2048,
        diskSizeInMb: 2048,
        timeoutInSeconds: 120,
      }),
      inputProps: props,
    });
    return new Response(JSON.stringify(response), {
      headers: { "Content-Type": "application/json" },
    });
  } catch (error) {
    console.error(error);
    return new Response(JSON.stringify({ error: (error as Error).message }), {
      headers: { "Content-Type": "application/json" },
      status: 500,
    });
  }
});

最佳实践

对于需要在 Supabase Edge Functions 中使用 Remotion Lambda 的开发者，建议：

1. 始终使用 @remotion/lambda-client 而非完整版客户端
2. 合理设置函数规格参数（内存、磁盘、超时时间）
3. 处理好错误边界和日志记录
4. 考虑使用 Supabase 存储作为输出目标

未来展望

这一轻量化方案不仅解决了 Supabase 环境下的集成问题，也为 Remotion 在其他资源受限环境中的应用开辟了可能性。未来可能会看到：

1. 更细粒度的模块划分
2. 对更多边缘计算平台的支持
3. 更智能的资源预估和分配机制

结语

通过 Remotion 团队的快速响应和优化，现在开发者可以轻松地在 Supabase Edge Functions 中调用 Remotion Lambda 服务，实现视频渲染的云端自动化。这一集成方案展示了现代前端技术与无服务器架构完美结合的可能性，为多媒体处理应用开发提供了新的思路。