跳到主要内容

Langflow 故障排除

本页面为您在使用 Langflow 或为 Langflow 做贡献时可能遇到的问题提供故障排除建议。

缺少组件​

随着 Langflow 开发的继续，组件经常被重新分类或弃用，以便更好地对齐或为新组件做准备。

如果组件似乎从组件菜单上的预期位置消失，请尝试以下操作：

  • 搜索组件或检查其他组件类别，包括包。
  • 显示遗留组件，它们默认是隐藏的。
  • 检查更改日志以了解最近版本中的组件更改。
  • 如果它是单次使用组件，请确保该组件尚未存在于您的流程中。

如果您仍然无法找到该组件，请参阅 Langflow GitHub 问题和讨论。

Playground 中没有输入​

如果Playground 中没有消息输入字段，请确保您的流程有一个聊天输入组件，它直接或间接连接到语言模型或代理组件的输入端口。

因为 Playground 是为使用 LLM 进行查询和响应格式的流程而设计的，例如聊天机器人和代理，流程必须具有聊天输入、语言模型/代理和聊天输出组件才能完全支持 Playground 的聊天界面。

有关更多信息，请参阅在 Playground 中测试流程。

缺少密钥、未找到密钥或无效的 API 密钥​

如果在运行流程时收到 API 密钥错误，请尝试以下操作：

  • 对于需要凭据的所有组件，请确保这些组件在组件设置中具有有效的凭据，例如 API 密钥字段。
  • 如果您将凭据存储在 Langflow 全局变量中，请确保您选择了正确的全局变量，并且该变量包含有效的凭据。
  • 确保提供的凭据处于活动状态，具有所需的权限，并且如果适用，帐户中有足够的资金来执行所需操作。例如，模型提供商需要信用额度来使用他们的 LLM。

Langflow 安装问题​

安装 Langflow 时可能出现以下问题。

Langflow 安装在 pip 依赖项解析时冻结​

使用 pip install langflow 安装 Langflow OSS 时缓慢失败，并显示此错误消息：


_10
pip is looking at multiple versions of <<library>> to determine which version is compatible with other requirements. This could take a while.

要解决此问题，请使用 uv 而不是 pip 安装 Langflow，如安装和运行 Langflow OSS Python 包中所述。

Linux 安装无法构建所需的包​

当您尝试在 Linux 上安装 Langflow OSS 时，由于过时或缺少的包而安装失败：


_10
Resolved 455 packages in 18.92s
_10
× Failed to build `webrtcvad==2.0.10`
_10
├─▶ The build backend returned an error
_10
╰─▶ Call to `setuptools.build_meta:__legacy__.build_wheel` failed (exit status: 1)

要解决此错误，请安装所需的构建依赖项，然后重试 Langflow 安装：


_10
sudo apt-get update
_10
sudo apt-get install build-essential python3-dev

如果升级包没有解决问题，请单独安装 gcc，然后重试 Langflow 安装：


_10
sudo apt-get install gcc

webrtcvad 包安装失败​

如果您遇到来自 webrtcvad 包的错误，请在您的虚拟环境中运行 uv pip install webrtcvad-wheels，然后重试 Langflow 安装。

Windows 上的 Langflow Desktop 需要 C++ 构建工具​

Microsoft Windows 安装的 Langflow Desktop 需要系统上可能不存在的 C++ 编译器。如果您收到 C++ Build Tools Required! 错误，请按照屏幕提示安装 Microsoft C++ Build Tools，或安装 Microsoft Visual Studio。

Langflow 启动问题​

尝试启动 Langflow 时可能出现以下问题。

没有 langflow.__main__ 模块​

当您尝试使用命令 langflow run 运行 Langflow 时，遇到以下错误：


_10
> No module named 'langflow.__main__'

要解决此问题，请尝试以下操作：

  1. 运行 uv run langflow run 而不是 langflow run。
  2. 如果这不起作用，请使用 uv pip install langflow -U 重新安装最新的 Langflow 版本。
  3. 如果这不起作用，请使用 uv pip install langflow --pre -U --force-reinstall 重新安装 Langflow 及其依赖项。

Langflow runTraceback​

当您尝试使用命令 langflow run 运行 Langflow 时，您遇到以下错误：


_10
> langflow runTraceback (most recent call last): File ".../langflow", line 5, in <module> from langflow.__main__ import mainModuleNotFoundError: No module named 'langflow.__main__'

此错误有两个可能的原因：

  • 多个 Langflow 安装：您使用 pip install langflow 安装了 Langflow，但您的系统中已经安装了以前版本的 Langflow。在这种情况下，您可能运行的是错误的可执行文件。

    要解决此问题，请通过运行 python -m langflow run 而不是 langflow run 来运行正确的可执行文件。

    如果这不起作用，请尝试使用 uv pip install langflow --pre -U 卸载并重新安装 Langflow。

  • 安装过程中的版本冲突：安装过程中可能发生了一些版本冲突。要解决此问题，请通过运行 python -m pip install langflow --pre -U --force-reinstall 重新安装 Langflow 及其依赖项。

终端中的环境变量不可用​

在您的终端中设置的环境变量不会自动可用于通过 Finder 或开始菜单启动的基于 GUI 的应用程序，如 Langflow Desktop。 要为 Langflow Desktop 设置环境变量，请参阅为 Langflow Desktop 设置环境变量。

包未安装​

在 Langflow OSS 中，您可以按照错误消息的说明安装缺少的依赖项。

要在 Langflow Desktop 中管理依赖项，请参阅在 Langflow Desktop 中安装自定义依赖项。

Langflow 升级问题​

升级 Langflow 版本时可能出现以下问题。

有关管理 Langflow 版本的信息，请参阅安装 Langflow。

运行迁移时出错​

以下错误可能在 Langflow 升级期间发生，当新版本无法覆盖 Langflow 缓存文件夹中的 langflow-pre.db 时：


_10
> Something went wrong running migrations. Please, run 'langflow migration --fix'

要解决此错误，请通过删除 Langflow 缓存文件夹的内容来清除缓存。

important

清除缓存会删除您的设置。 如果您想保留设置文件，请在清除缓存文件夹之前创建这些文件的备份。

缓存文件夹的位置取决于您的操作系统：

  • Linux: home/<username>/.cache/langflow/
  • WSL2 on Windows: home/<username>/.cache/langflow/
  • macOS: /Users/<username>/Library/Caches/langflow/

Langflow 卸载问题​

卸载 Langflow 时可能出现以下问题。

在 macOS 上卸载 Langflow Desktop 时不会删除点目录​

在 macOS 上，卸载 Langflow Desktop 会删除 .app 文件，但不会删除 ~/.langflow 中的文件，其中包括使用期间生成的文件，如缓存和设置。

如果您重新安装 Langflow Desktop，它将使用先前安装的现有数据启动。

要完全删除 Langflow Desktop macOS 安装，您还必须删除 ~/.langflow：


_10
rm -rf .langflow

MCP 服务器问题​

自定义组件和集成问题​

有关第三方集成的故障排除建议，请参阅 Langflow 文档和提供商文档中有关该集成的信息。

如果您正在构建自定义组件，请参阅自定义 Python 组件的错误处理和日志记录。

另请参阅​

Search