解决 LobeChat 在 Vercel 上部署失败：maxDuration 错误与 Fluid Compute 解决方案

type

Post

status

Published

date

Oct 29, 2025

slug

vercel-lobechat-maxduration-deployment-failure-solution

summary

报错信息“Error: Builder returned invalid maxDuration value for Serverless Function "webapi/create-image/comfyui". Serverless Functions must have a maxDuration between 1 and 60 for plan hobby. : https://vercel.com/docs/concepts/limits/overview#serverless-function-execution-timeout”

背景

本文旨在解决LobeChat用户在Vercel平台部署时遇到的常见maxDuration错误，特别是针对使用Hobby（免费）计划的用户。当LobeChat项目因Serverless Function的执行时间超出Vercel Hobby计划的限制而导致部署失败时，Vercel的Fluid Compute功能提供了一个有效的解决方案。

当前遇到的问题

在使用LobeChat v1.114.0版本进行部署时，用户可能会持续遇到升级失败的问题。即使尝试参考GitHub Issues中的相关讨论（例如 issue #9153），并将Serverless Function的maxDuration值修改为60秒或更低，部署仍然会失败，并显示以下错误信息：

Error: Builder returned invalid maxDuration value for Serverless Function "webapi/create-image/comfyui". Serverless Functions must have a maxDuration between 1 and 60 for plan hobby. : https://vercel.com/docs/concepts/limits/overview#serverless-function-execution-timeout

这个错误明确指出，Vercel Hobby计划的Serverless Functions的maxDuration必须在1到60秒之间。LobeChat中某些功能，特别是涉及到图像生成（如webapi/create-image/comfyui）的API，可能需要较长的执行时间，从而超出了这个限制。

解决方案：启用 Vercel 的 Fluid Compute 功能

针对上述maxDuration限制导致的部署失败，启用 Vercel 的 Fluid Compute 功能 是一个推荐且高效的解决方案。

Fluid Compute 功能能够显著延长 Serverless Functions 的执行时间。即使是 Vercel 的 Hobby 计划，在启用 Fluid Compute 后，Serverless Functions 的最长执行时间也可以达到 300 秒（即 5 分钟）。这对于像图像生成这样可能需要较长时间完成的任务来说，提供了足够的执行窗口。