dify 1.13.2 發(fā)布：關(guān)鍵回歸修復(fù)、穩(wěn)定性全面提升與完整升級實戰(zhàn)指南

2026年3月20日，dify 正式發(fā)布v1.13.2 Latest。這是一個以修復(fù)為核心的關(guān)鍵補丁版本，主要目標(biāo)是解決 v1.13.1 中引入的多項嚴(yán)重回歸問題和穩(wěn)定性隱患，尤其集中在LLM 調(diào)用鏈路、知識檢索節(jié)點、插件數(shù)據(jù)庫連接、Weaviate 客戶端生命周期管理等生產(chǎn)環(huán)境高頻場景。

對于已經(jīng)部署 dify 的團隊來說，1.13.2 不是可選升級，而是強烈建議升級的穩(wěn)定性版本。本文將基于官方發(fā)布內(nèi)容，對本次更新進行完整、逐條、無遺漏的技術(shù)解讀，并提供Docker Compose 與源碼部署的詳細升級步驟，幫助你安全完成升級。

一、版本概覽

• ?版本號：1.13.2

• ?發(fā)布時間：2026年3月20日

• ?版本類型：補丁版本（Patch Release）

• ?核心目標(biāo)：

• • ? 修復(fù) v1.13.1 引入的嚴(yán)重回歸

  • ? 恢復(fù) LLM 節(jié)點與插件調(diào)用穩(wěn)定性

  • ? 修復(fù)知識檢索節(jié)點執(zhí)行失敗問題

  • ? 改善 Weaviate 客戶端資源清理

  • ? 提升整體系統(tǒng)運行可靠性

在 v1.13.1 中，Prompt Message 的轉(zhuǎn)換邏輯出現(xiàn)嚴(yán)重回歸，直接導(dǎo)致多個依賴 LLM 的節(jié)點在運行時發(fā)生異常。

受影響范圍包括但不限于：

• ? LLM 節(jié)點

• ? Question Classifier（問題分類器）

• ? 其他基于 LLM 插件機制的節(jié)點

該問題的直接后果是：

• ? Prompt 內(nèi)容在傳遞給模型前被錯誤轉(zhuǎn)換

• ? 插件調(diào)用失敗

• ? 工作流執(zhí)行中斷

• ? LLM 節(jié)點表現(xiàn)為“無響應(yīng)”或直接報錯

這類問題通常只在運行時暴露，對生產(chǎn)環(huán)境影響極大。

v1.13.2 已徹底修復(fù)該回歸問題，并恢復(fù)原有的 Prompt Message 轉(zhuǎn)換邏輯。

2. Knowledge Retrieval 節(jié)點執(zhí)行失敗

另一個高頻問題出現(xiàn)在Knowledge Retrieval（知識檢索）節(jié)點。

問題根源在于：

• ? 枚舉值發(fā)生不兼容變更

• ? 新舊枚舉值之間未正確兼容

• ? 導(dǎo)致節(jié)點在執(zhí)行階段直接失敗

該問題會直接影響：

• ? 基于知識庫的問答應(yīng)用

• ? RAG 工作流

• ? 企業(yè)內(nèi)部知識檢索場景

在 1.13.2 中，已修復(fù)所有因枚舉不兼容導(dǎo)致的節(jié)點執(zhí)行失敗問題，確保現(xiàn)有知識庫配置無需修改即可正常運行。

3. Weaviate 客戶端清理邏輯不當(dāng)

在之前版本中，Weaviate 客戶端存在不合理的銷毀邏輯：

• ? 客戶端在生命周期結(jié)束時被顯式調(diào)用刪除方法

• ? 實際運行中容易導(dǎo)致連接異?；蛸Y源釋放問題

v1.13.2 對此進行了調(diào)整：

• ?移除 Weaviate 客戶端的 del 方法調(diào)用

• ? 避免潛在的連接不穩(wěn)定和資源異常釋放問題

這一改動對使用 Weaviate 作為向量數(shù)據(jù)庫的部署尤為重要。

4. CreatorUserRole 兼容性問題

在 API 層面，用戶角色字段存在兼容性不足的問題：

• ? 某些場景使用end-user

• ? 某些場景使用end_user

• ? 導(dǎo)致角色解析異常

v1.13.2 已統(tǒng)一處理：

• ?CreatorUserRole 同時接受end-user與end_user

• ? 避免歷史數(shù)據(jù)或第三方集成出現(xiàn)角色校驗失敗

在升級到 dify 1.13.2 之前，請?zhí)貏e注意以下配置要求。

1. 自定義 CELERY_QUEUES 的用戶

如果你使用了自定義CELERY_QUEUES，必須確保包含以下隊列：

• ?workflow_based_app_execution

否則將導(dǎo)致：

• ? 工作流類應(yīng)用無法正常執(zhí)行

• ? Worker 進程無法消費對應(yīng)任務(wù)

如果你啟用了：

ENABLE_API_TOKEN_LAST_USED_UPDATE_TASK=true

那么CELERY_QUEUES 中還必須額外包含：

• ?api_token

否則 API Token 最近使用時間更新任務(wù)將無法執(zhí)行。

四、Docker Compose 部署升級指南

以下步驟適用于使用 Docker Compose 部署 dify 的場景。

1. 備份 docker-compose 配置文件（可選但強烈建議）

進入 docker 目錄后執(zhí)行：

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

git checkout main
git pull origin main

請確保在 docker 目錄中執(zhí)行：

docker compose down

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

docker compose up -d

在某些環(huán)境中，升級后可能遇到如下錯誤：

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

錯誤表現(xiàn)為：

• ? 插件數(shù)據(jù)庫初始化失敗

• ? PostgreSQL 主機名無法解析

• ? 服務(wù)直接 panic 退出

解決方式：請使用以下命令啟動服務(wù)：

docker compose --profile postgresql up -d

該方式可確保 PostgreSQL 服務(wù)正確啟動并被依賴服務(wù)識別。

五、源碼部署升級指南

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

1. 停止所有服務(wù)

包括：

• ? API Server

• ? Worker

• ? Web Frontend Server

git checkout 1.13.2

cd api
uv sync

uv run flask db upgrade

完成以上步驟后，重新啟動 API、Worker 和 Web 前端服務(wù)即可。

六、完整變更記錄匯總

本次 1.13.2 版本包含以下變更內(nèi)容：

• ? 版本號更新至 1.13.2

• ? 修復(fù) max_retries 被硬編碼的問題

• ? 修復(fù) fetch_prompt_messages 中 Prompt 內(nèi)容轉(zhuǎn)換邏輯

• ? 移除 Weaviate 客戶端不當(dāng)?shù)膭h除方法

• ? CreatorUserRole 同時支持end-user與end_user

這些改動雖然看似細節(jié)，但都直接關(guān)系到生產(chǎn)穩(wěn)定性與兼容性。

七、總結(jié)：為什么必須升級到 dify 1.13.2

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

dify 1.13.2 并不是功能堆疊型版本，而是一個面向穩(wěn)定性的關(guān)鍵修復(fù)版本，適合所有正在運行 dify 1.13.x 的用戶。

升級后的核心收益包括：

• ? LLM 節(jié)點與插件調(diào)用全面恢復(fù)穩(wěn)定

• ? 知識檢索節(jié)點不再因枚舉問題失敗

• ? Weaviate 向量數(shù)據(jù)庫連接更可靠

• ? API 用戶角色兼容性顯著提升

• ? Docker 與源碼部署流程更加清晰、安全

我們相信人工智能為普通人提供了一種“增強工具”，并致力于分享全方位的AI知識。在這里，您可以找到最新的AI科普文章、工具評測、提升效率的秘籍以及行業(yè)洞察。 歡迎關(guān)注“福大大架構(gòu)師每日一題”，發(fā)消息可獲得面試資料，讓AI助力您的未來發(fā)展。