无效许可证¶
当尝试启动自托管的 LangGraph 平台服务器时,若许可证验证失败,则会引发此错误。此错误是 LangGraph 平台特有的,与开源库无关。
何时会出现此情况¶
当在没有有效的企业许可证或 API 密钥的情况下运行 LangGraph 平台的自托管部署时,会出现此错误。
故障排除¶
确认部署类型¶
首先,确认所需的部署模式。
本地开发¶
如果您只是在本地进行开发,可以通过运行 langgraph dev
来使用轻量级的内存服务器。
有关更多信息,请参阅本地服务器文档。
托管式 LangGraph 平台¶
如果您需要一个快速的托管环境,可以考虑云 SaaS 部署选项。此选项无需额外的许可证密钥。
自托管精简版(功能有限)¶
如果您的部署每年的节点执行次数不太可能超过 100 万次,并且不需要定时任务和其他企业级功能,可以考虑自托管精简版部署选项。
您可以通过在环境中(例如,在 langgraph.json
引用的 .env
文件中)设置有效的 LANGSMITH_API_KEY
并构建 Docker 镜像来使用自托管精简版进行部署。该 API 密钥必须与 高级 计划或更高级别的账户关联。
自托管企业版(全功能)¶
对于完全自托管,需设置 LANGGRAPH_CLOUD_LICENSE_KEY
环境变量。如果您对企业版许可证密钥感兴趣,请联系 LangChain 支持团队。
有关部署选项及其功能的更多信息,请参阅部署选项文档。
确认凭证¶
如果您已确认要自托管 LangGraph 平台,请验证您的凭证。
自托管精简版¶
- 确认您已在部署环境或
.env
文件中提供了有效的LANGSMITH_API_KEY
环境变量。 - 确认所提供的 API 密钥与 高级 或 企业 计划(或同等计划)的账户关联。
自托管企业版¶
- 确认您已在部署环境或
.env
文件中提供了有效的LANGGRAPH_CLOUD_LICENSE_KEY
环境变量。 - 确认该密钥仍然有效且未超过其有效期。