Skip to content

INVALID_LICENSE

当尝试启动自托管的 LangGraph 平台服务器时,如果许可证验证失败,就会引发此错误。此错误特定于 LangGraph 平台,与开源库无关。

出现此情况时

在没有有效的企业许可证或 API 密钥的情况下运行自托管的 LangGraph 平台部署时,会出现此错误。

故障排除

确认部署类型

首先,确认所需的部署模式。

本地开发

如果你只是在本地进行开发,可以通过运行 langgraph dev 使用轻量级的内存服务器。 有关更多信息,请参阅本地服务器文档。

管理型 LangGraph 平台

如果你想使用快速的托管环境,请考虑 Cloud SaaS 部署选项。这不需要额外的许可证密钥。

独立容器(Lite)

如果你的部署每年预计执行的节点数不超过一百万,并且不需要定时任务和其他企业功能,请考虑使用 独立容器 部署选项。

你可以通过在环境中设置有效的 LANGSMITH_API_KEY(例如,在 langgraph.json 引用的 .env 文件中)并构建 Docker 镜像来部署独立容器。该 API 密钥必须与 Plus 计划或更高计划上的账户相关联。

独立容器(Enterprise)

如需完全自托管,请设置环境变量 LANGGRAPH_CLOUD_LICENSE_KEY。如果您有兴趣获取企业许可证密钥,请联系 LangChain 支持团队。

有关部署选项及其功能的更多信息,请参阅 部署选项 文档。

确认凭证

如果你已经确认要自行托管 LangGraph 平台,请验证你的凭证。

独立容器(Lite)

  1. 确认你在部署环境中或 .env 文件中提供了有效的 LANGSMITH_API_KEY 环境变量
  2. 确认提供的 API 密钥与 PlusEnterprise 计划(或等效计划)上的账户相关联

独立容器(Enterprise)

  1. 确认你在部署环境中或 .env 文件中提供了有效的 LANGGRAPH_CLOUD_LICENSE_KEY 环境变量
  2. 确认密钥仍然有效且未超过其过期日期