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

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

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

一、版本概覽

• ?版本號(hào)：1.13.2

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

• ?版本類型：補(bǔ)丁版本（Patch Release）

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

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

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

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

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

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

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

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

• ? LLM 節(jié)點(diǎn)

• ? Question Classifier（問(wèn)題分類器）

• ? 其他基于 LLM 插件機(jī)制的節(jié)點(diǎn)

該問(wèn)題的直接后果是：

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

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

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

• ? LLM 節(jié)點(diǎn)表現(xiàn)為“無(wú)響應(yīng)”或直接報(bào)錯(cuò)

這類問(wèn)題通常只在運(yùn)行時(shí)暴露，對(duì)生產(chǎn)環(huán)境影響極大。

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

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

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

問(wèn)題根源在于：

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

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

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

該問(wèn)題會(huì)直接影響：

• ? 基于知識(shí)庫(kù)的問(wèn)答應(yīng)用

• ? RAG 工作流

• ? 企業(yè)內(nèi)部知識(shí)檢索場(chǎng)景

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

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

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

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

• ? 實(shí)際運(yùn)行中容易導(dǎo)致連接異常或資源釋放問(wèn)題

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

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

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

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

4. CreatorUserRole 兼容性問(wèn)題

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

• ? 某些場(chǎng)景使用end-user

• ? 某些場(chǎng)景使用end_user

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

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

• ?CreatorUserRole 同時(shí)接受end-user與end_user

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

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

1. 自定義 CELERY_QUEUES 的用戶

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

• ?workflow_based_app_execution

否則將導(dǎo)致：

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

• ? Worker 進(jìn)程無(wú)法消費(fèi)對(duì)應(yīng)任務(wù)

如果你啟用了：

ENABLE_API_TOKEN_LAST_USED_UPDATE_TASK=true

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

• ?api_token

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

四、Docker Compose 部署升級(jí)指南

以下步驟適用于使用 Docker Compose 部署 dify 的場(chǎng)景。

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

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

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

git checkout main
git pull origin main

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

docker compose down

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

docker compose up -d

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

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

錯(cuò)誤表現(xiàn)為：

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

• ? PostgreSQL 主機(jī)名無(wú)法解析

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

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

docker compose --profile postgresql up -d

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

五、源碼部署升級(jí)指南

如果你使用的是Source Code Deployment（源碼部署），請(qǐng)按照以下流程升級(jí)。

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

包括：

• ? API Server

• ? Worker

• ? Web Frontend Server

git checkout 1.13.2

cd api
uv sync

uv run flask db upgrade

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

六、完整變更記錄匯總

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

• ? 版本號(hào)更新至 1.13.2

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

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

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

• ? CreatorUserRole 同時(shí)支持end-user與end_user

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

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

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

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

升級(jí)后的核心收益包括：

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

• ? 知識(shí)檢索節(jié)點(diǎn)不再因枚舉問(wèn)題失敗

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

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

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

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