一、版本概述

2025年12月12日，dify 發(fā)布了1.11.1版本。這次更新包含了非常重要的安全補(bǔ)丁、性能提升以及若干 Bug 修復(fù)，官方強(qiáng)烈建議所有用戶盡快升級(jí)到該版本，以保障系統(tǒng)的安全與穩(wěn)定。
這一版本的重點(diǎn)是強(qiáng)化安全性、提升性能以及優(yōu)化用戶體驗(yàn)，具體更新內(nèi)容如下。

二、修復(fù)與改進(jìn)

1. 1.React 和 Next.js 安全升級(jí)
   將 react 與 react-dom 升級(jí)至 19.2.3，修復(fù)已知的 CVE 安全漏洞。同時(shí)，Next.js 也完成了安全更新，提升前端安全性。

2. 2.憑證管理優(yōu)化
   修復(fù)了available_credentials為空的問題，保證憑證的正常讀取與使用。

3. 3.描述長度限制
   自動(dòng)生成的描述會(huì)進(jìn)行截?cái)?，避免超過 400 字符限制導(dǎo)致提交失敗，從而提升提交的順暢度。

4. 4.內(nèi)容類型 Charset 設(shè)置
   響應(yīng)內(nèi)容類型中添加了 charset，保證數(shù)據(jù)格式的一致性與正確性。

5. 5.Flask-Restx 屬性錯(cuò)誤修復(fù)
   移除了validate=True參數(shù)，解決了在 flask-restx 中產(chǎn)生的 AttributeError。

6. 6.文檔處理優(yōu)化
   優(yōu)化了save_document_with_dataset_id函數(shù)的性能，并修復(fù)了 DOCX 文件中外部圖片導(dǎo)致的提取失敗問題。

7. 7.Token 獲取優(yōu)化
   當(dāng)access_token為空時(shí)，不再拋出錯(cuò)誤，而是返回None，提高系統(tǒng)容錯(cuò)能力。

8. 8.Hit-Test 失敗問題修復(fù)
   針對不存在的附件 ID 導(dǎo)致 hit-test 失敗的問題進(jìn)行了修復(fù)。

三、新功能

• ?Amplitude 集成
  在布局和 provider 組件中集成 Amplitude API Key，實(shí)現(xiàn)增強(qiáng)的分析與數(shù)據(jù)統(tǒng)計(jì)能力。

四、測試增強(qiáng)

• ?容器集成測試
  在容器環(huán)境中為觸發(fā)器增加了集成測試，確保運(yùn)行的穩(wěn)定性與兼容性。

五、性能優(yōu)化

1. 1.Excel 提取器優(yōu)化
   提升了 Excel 數(shù)據(jù)提取器的性能與內(nèi)存使用效率，使數(shù)據(jù)處理更加快速高效。

2. 2.文檔保存性能優(yōu)化
   優(yōu)化save_document_with_dataset_id方法，減少性能開銷。

六、升級(jí)指南

1. Docker Compose 部署

備份自定義 docker-compose 配置文件（可選）：
.

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

獲取最新代碼：
.

git checkout main
git pull origin main

停止服務(wù)（在 docker 目錄執(zhí)行）：
.

docker compose down

備份數(shù)據(jù)：
.

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

升級(jí)服務(wù)：

docker compose up -d

注意
如果遇到以下數(shù)據(jù)庫連接錯(cuò)誤：
.

failed to connect to `host=db_postgres user=postgres database=dify_plugin`: hostname resolving error ...

請使用以下命令：
.

docker compose --profile postgresql up -d

2. 源碼部署

停止 API Server、Worker、Web 前端服務(wù)：

獲取最新代碼：
.

git checkout 1.11.1

更新 Python 依賴：
.

cd api
uv sync

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

uv run flask db upgrade

重新運(yùn)行 API Server、Worker、Web 前端服務(wù)。

七、版本更新列表

• ? 升級(jí) react 和 react-dom 至 19.2.3，修復(fù) CVE 漏洞

• ? 修復(fù) available_credentials 為空的問題

• ? Next.js 安全更新

• ? 自動(dòng)生成描述截?cái)?，避免超?400 字符限制

• ? 增加容器環(huán)境觸發(fā)器集成測試

• ? 集成 Amplitude API Key

• ? 設(shè)置響應(yīng)內(nèi)容類型 charset

• ? 修復(fù) flask-restx AttributeError

• ? 優(yōu)化 Excel 提取器性能與內(nèi)存

• ? 優(yōu)化 save_document_with_dataset_id

• ? 修復(fù) DOCX 外部圖片提取失敗

• ? 修復(fù)附件 ID 不存在導(dǎo)致的 hit-test 失敗

• ? 當(dāng) access_token 為空時(shí)返回 None

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

八、總結(jié)

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

dify 1.11.1 是一次重要的版本更新，包含安全補(bǔ)丁、性能提升和新功能。建議用戶第一時(shí)間升級(jí)，特別是涉及到安全漏洞修復(fù)的部分，對系統(tǒng)安全至關(guān)重要。

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