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

2026-03-21 00:11:14　來源: moonfdd

北京舉報(bào)

分享至

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)定性隱患，尤其集中在LLM 調(diào)用鏈路、知識檢索節(jié)點(diǎn)、插件數(shù)據(jù)庫連接、Weaviate 客戶端生命周期管理等生產(chǎn)環(huán)境高頻場景。

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

一、版本概覽

?版本號：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ù)知識檢索節(jié)點(diǎn)執(zhí)行失敗問題
- ? 改善 Weaviate 客戶端資源清理
- ? 提升整體系統(tǒng)運(yùn)行可靠性

二、v1.13.1 中引入的關(guān)鍵問題回顧 1. Prompt Message 轉(zhuǎn)換的嚴(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（問題分類器）
? 其他基于 LLM 插件機(jī)制的節(jié)點(diǎn)

該問題的直接后果是：

? Prompt 內(nèi)容在傳遞給模型前被錯(cuò)誤轉(zhuǎn)換
? 插件調(diào)用失敗
? 工作流執(zhí)行中斷
? LLM 節(jié)點(diǎn)表現(xiàn)為“無響應(yīng)”或直接報(bào)錯(cuò)

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

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

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

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

問題根源在于：

? 枚舉值發(fā)生不兼容變更
? 新舊枚舉值之間未正確兼容
? 導(dǎo)致節(jié)點(diǎn)在執(zhí)行階段直接失敗

該問題會直接影響：

? 基于知識庫的問答應(yīng)用
? RAG 工作流
? 企業(yè)內(nèi)部知識檢索場景

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

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

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

? 客戶端在生命周期結(jié)束時(shí)被顯式調(diào)用刪除方法
? 實(shí)際運(yùn)行中容易導(dǎo)致連接異?；蛸Y源釋放問題

v1.13.2 對此進(jìn)行了調(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 同時(shí)接受end-user與end_user
? 避免歷史數(shù)據(jù)或第三方集成出現(xiàn)角色校驗(yàn)失敗

三、重要升級提示（務(wù)必閱讀）

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

1. 自定義 CELERY_QUEUES 的用戶

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

?workflow_based_app_execution

否則將導(dǎo)致：

? 工作流類應(yīng)用無法正常執(zhí)行
? Worker 進(jìn)程無法消費(fèi)對應(yīng)任務(wù)

2. ENABLE_API_TOKEN_LAST_USED_UPDATE_TASK 配置

如果你啟用了：

ENABLE_API_TOKEN_LAST_USED_UPDATE_TASK=true

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

?api_token

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

四、Docker Compose 部署升級指南

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

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

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

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

2. 拉取最新主分支代碼

git checkout main
git pull origin main

3. 停止服務(wù)

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

docker compose down

4. 備份數(shù)據(jù)卷

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

5. 啟動升級后的服務(wù)

docker compose up -d

6. 常見錯(cuò)誤與解決方案

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

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

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

? 插件數(shù)據(jù)庫初始化失敗
? PostgreSQL 主機(jī)名無法解析
? 服務(wù)直接 panic 退出

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

docker compose --profile postgresql up -d

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

五、源碼部署升級指南

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

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

包括：

? API Server
? Worker
? Web Frontend Server

2. 切換到 1.13.2 發(fā)布分支

git checkout 1.13.2

3. 更新 Python 依賴

cd api
uv sync

4. 執(zhí)行數(shù)據(jù)庫遷移

uv run flask db upgrade

5. 重新啟動所有服務(wù)

完成以上步驟后，重新啟動 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 同時(shí)支持end-user與end_user

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

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

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

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

升級后的核心收益包括：

? LLM 節(jié)點(diǎn)與插件調(diào)用全面恢復(fù)穩(wěn)定
? 知識檢索節(jié)點(diǎn)不再因枚舉問題失敗
? Weaviate 向量數(shù)據(jù)庫連接更可靠
? API 用戶角色兼容性顯著提升
? Docker 與源碼部署流程更加清晰、安全

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

特別聲明：以上內(nèi)容(如有圖片或視頻亦包括在內(nèi))為自媒體平臺“網(wǎng)易號”用戶上傳并發(fā)布，本平臺僅提供信息存儲服務(wù)。

Notice: The content above (including the pictures and videos if any) is uploaded and posted by a user of NetEase Hao, which is a social media platform and only provides information storage services.