北京
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).bakgit checkout main
git pull origin main請確保在 docker 目錄中執行：
docker compose downtar -cvf volumes-$(date +%s).tgz volumesdocker 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.2cd api
uv syncuv 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助力您的未來發展。
特別聲明：以上內容(如有圖片或視頻亦包括在內)為自媒體平臺“網易號”用戶上傳并發布，本平臺僅提供信息存儲服務。
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.
