跳到内容

无效许可证

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

发生时

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

故障排除

确认部署类型

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

适用于本地开发

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

适用于托管 LangGraph 平台

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

适用于独立容器(精简版)

如果您的部署每年不太可能超过 100 万个节点执行,并且不需要 Cron 和其他企业功能,请考虑独立容器部署选项。

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

适用于独立容器(企业版)

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

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

确认凭据

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

适用于独立容器(精简版)

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

适用于独立容器(企业版)

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