dify 1.13.2 发布：关键回归修复、稳定性全面提升与完整升级实战指南

2026年3月20日，dify 正式发布v1.13.2 Latest。这是一个以修复为核心的关键补丁版本，主要目标是解决 v1.13.1 中引入的多项严重回归问题和稳定性隐患，尤其集中在LLM 调用链路、知识检索节点、插件数据库连接、Weaviate 客户端生命周期管理等生产环境高频场景。

对于已经部署 dify 的团队来说，1.13.2 不是可选升级，而是强烈建议升级的稳定性版本。本文将基于官方发布内容，对本次更新进行完整、逐条、无遗漏的技术解读，并提供Docker Compose 与源码部署的详细升级步骤，帮助你安全完成升级。

一、版本概览

• •版本号：1.13.2

• •发布时间：2026年3月20日

• •版本类型：补丁版本（Patch Release）

• •核心目标：

• • • 修复 v1.13.1 引入的严重回归

  • • 恢复 LLM 节点与插件调用稳定性

  • • 修复知识检索节点执行失败问题

  • • 改善 Weaviate 客户端资源清理

  • • 提升整体系统运行可靠性

在 v1.13.1 中，Prompt Message 的转换逻辑出现严重回归，直接导致多个依赖 LLM 的节点在运行时发生异常。

受影响范围包括但不限于：

• • LLM 节点

• • Question Classifier（问题分类器）

• • 其他基于 LLM 插件机制的节点

该问题的直接后果是：

• • Prompt 内容在传递给模型前被错误转换

• • 插件调用失败

• • 工作流执行中断

• • LLM 节点表现为“无响应”或直接报错

这类问题通常只在运行时暴露，对生产环境影响极大。

v1.13.2 已彻底修复该回归问题，并恢复原有的 Prompt Message 转换逻辑。

2. Knowledge Retrieval 节点执行失败

另一个高频问题出现在Knowledge Retrieval（知识检索）节点。

问题根源在于：

• • 枚举值发生不兼容变更

• • 新旧枚举值之间未正确兼容

• • 导致节点在执行阶段直接失败

该问题会直接影响：

• • 基于知识库的问答应用

• • RAG 工作流

• • 企业内部知识检索场景

在 1.13.2 中，已修复所有因枚举不兼容导致的节点执行失败问题，确保现有知识库配置无需修改即可正常运行。

3. Weaviate 客户端清理逻辑不当

在之前版本中，Weaviate 客户端存在不合理的销毁逻辑：

• • 客户端在生命周期结束时被显式调用删除方法

• • 实际运行中容易导致连接异常或资源释放问题

v1.13.2 对此进行了调整：

• •移除 Weaviate 客户端的 del 方法调用

• • 避免潜在的连接不稳定和资源异常释放问题

这一改动对使用 Weaviate 作为向量数据库的部署尤为重要。

4. CreatorUserRole 兼容性问题

在 API 层面，用户角色字段存在兼容性不足的问题：

• • 某些场景使用end-user

• • 某些场景使用end_user

• • 导致角色解析异常

v1.13.2 已统一处理：

• •CreatorUserRole 同时接受end-user与end_user

• • 避免历史数据或第三方集成出现角色校验失败

在升级到 dify 1.13.2 之前，请特别注意以下配置要求。

1. 自定义 CELERY_QUEUES 的用户

如果你使用了自定义CELERY_QUEUES，必须确保包含以下队列：

• •workflow_based_app_execution

否则将导致：

• • 工作流类应用无法正常执行

• • Worker 进程无法消费对应任务

如果你启用了：

ENABLE_API_TOKEN_LAST_USED_UPDATE_TASK=true

那么CELERY_QUEUES 中还必须额外包含：

• •api_token

否则 API Token 最近使用时间更新任务将无法执行。

四、Docker Compose 部署升级指南

以下步骤适用于使用 Docker Compose 部署 dify 的场景。

1. 备份 docker-compose 配置文件（可选但强烈建议）

进入 docker 目录后执行：

cd docker
cp docker-compose.yaml docker-compose.yaml.$(date +%s).bak

git checkout main
git pull origin main

请确保在 docker 目录中执行：

docker compose down

tar -cvf volumes-$(date +%s).tgz volumes

docker compose up -d

在某些环境中，升级后可能遇到如下错误：

failed to initialize database
failed to connect to host=db_postgres
hostname resolving error
server misbehaving

错误表现为：

• • 插件数据库初始化失败

• • PostgreSQL 主机名无法解析

• • 服务直接 panic 退出

解决方式：请使用以下命令启动服务：

docker compose --profile postgresql up -d

该方式可确保 PostgreSQL 服务正确启动并被依赖服务识别。

五、源码部署升级指南

如果你使用的是Source Code Deployment（源码部署），请按照以下流程升级。

1. 停止所有服务

包括：

• • API Server

• • Worker

• • Web Frontend Server

git checkout 1.13.2

cd api
uv sync

uv run flask db upgrade

完成以上步骤后，重新启动 API、Worker 和 Web 前端服务即可。

六、完整变更记录汇总

本次 1.13.2 版本包含以下变更内容：

• • 版本号更新至 1.13.2

• • 修复 max_retries 被硬编码的问题

• • 修复 fetch_prompt_messages 中 Prompt 内容转换逻辑

• • 移除 Weaviate 客户端不当的删除方法

• • CreatorUserRole 同时支持end-user与end_user

这些改动虽然看似细节，但都直接关系到生产稳定性与兼容性。

七、总结：为什么必须升级到 dify 1.13.2

代码地址：github.com/langgenius/dify

dify 1.13.2 并不是功能堆叠型版本，而是一个面向稳定性的关键修复版本，适合所有正在运行 dify 1.13.x 的用户。

升级后的核心收益包括：

• • LLM 节点与插件调用全面恢复稳定

• • 知识检索节点不再因枚举问题失败

• • Weaviate 向量数据库连接更可靠

• • API 用户角色兼容性显著提升

• • Docker 与源码部署流程更加清晰、安全

我们相信人工智能为普通人提供了一种“增强工具”，并致力于分享全方位的AI知识。在这里，您可以找到最新的AI科普文章、工具评测、提升效率的秘籍以及行业洞察。 欢迎关注“福大大架构师每日一题”，发消息可获得面试资料，让AI助力您的未来发展。