打开网易新闻 查看精彩图片
打开网易新闻 查看精彩图片
打开网易新闻 查看精彩图片

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 中引入的关键问题回顾 1. Prompt Message 转换的严重回归问题

在 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 进程无法消费对应任务

2. ENABLE_API_TOKEN_LAST_USED_UPDATE_TASK 配置

如果你启用了：

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
2. 拉取最新主分支代码

git checkout main
git pull origin main
3. 停止服务

请确保在 docker 目录中执行：

docker compose down
4. 备份数据卷

tar -cvf volumes-$(date +%s).tgz volumes
5. 启动升级后的服务

docker compose up -d
6. 常见错误与解决方案

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

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

2. 切换到 1.13.2 发布分支

git checkout 1.13.2
3. 更新 Python 依赖

cd api
uv sync
4. 执行数据库迁移

uv run flask db upgrade
5. 重新启动所有服务

完成以上步骤后，重新启动 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助力您的未来发展。