跳到内容

INVALID_LICENSE

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

出现此情况时

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

故障排除

确认部署类型

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

针对本地开发

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

针对托管式LangGraph平台

如果您需要一个快速托管环境,请考虑云SaaS部署选项。这不需要额外的许可证密钥。

针对独立容器(Lite版)

如果您的部署每年节点执行次数不太可能超过100万,并且不需要定时任务(Crons)和其他企业功能,请考虑独立容器部署选项。

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

针对独立容器(企业版)

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

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

确认凭据

如果您已确认希望自托管 LangGraph 平台,请验证您的凭据。

针对独立容器(Lite版)

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

针对独立容器(企业版)

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