跳到主要内容

Langflow 故障排除

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

缺少组件​

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

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

  • 搜索该组件或检查其他组件类别，包括 bundles。
  • 显示传统组件，这些组件默认情况下是隐藏的。
  • 查看 Changelog 了解最近版本中的组件变更。
  • 如果是单次使用组件，请确保该组件尚未存在于您的流程中。

如果您仍然无法找到该组件，请参阅 Langflow GitHub Issues and Discussions。

Playground 中没有输入​

如果 Playground 中没有消息输入字段，请确保您的流程中有一个 Chat Input 组件，该组件直接或间接连接到 Language Model 或 Agent 组件的 Input 端口。

由于 Playground 专为使用 LLM 进行查询和响应格式的流程而设计，例如聊天机器人和代理，因此流程必须包含 Chat Input、Language Model/Agent 和 Chat Output 组件，才能被 Playground 聊天界面完全支持。

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

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

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

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

Langflow 安装问题​

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

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

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


_10
pip 正在查看 <<library>> 的多个版本，以确定哪个版本与其他要求兼容。这可能需要一些时间。

要解决此问题，请使用 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++ 构建工具​

Langflow Desktop 的 Microsoft Windows 安装需要一个可能不在您的系统上的 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 文档和提供商文档中关于该集成的信息。

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

自定义组件未在可视化编辑器中显示​

如果您的自定义组件未在 Langflow 可视化编辑器中显示，请尝试以下故障排除步骤：

  1. 确保您的组件遵循 必需的目录结构。


    _10
    /your/custom/components/path/ # Base directory set by LANGFLOW_COMPONENTS_PATH
    _10
    └── category_name/ # Required category subfolder that determines menu name
    _10
    ├── __init__.py # Required
    _10
    └── custom_component.py # Component file

  2. 验证每个类别目录都包含一个 __init__.py 文件。 这是必需的，以便 Python 能够将该目录识别为模块。

  3. 对于 LANGFLOW_COMPONENTS_PATH，请使用命令行参数而不是环境变量。 如果您正在使用 LANGFLOW_COMPONENTS_PATH 环境变量但组件未加载，请尝试使用 --components-path 命令行参数：


    _10
    uv run langflow run --components-path /path/to/your/custom/components

如果您继续遇到问题，请 在 GitHub 上报告，并提供您的目录结构和组件设置的详细信息。

另请参阅​

Search