dify 1.11.1 版本发布：重要安全更新、性能优化与新特性解析

一、版本概述

2025年12月12日，dify 发布了 1.11.1 版本。这次更新包含了非常重要的安全补丁、性能提升以及若干 Bug 修复，官方强烈建议所有用户尽快升级到该版本，以保障系统的安全与稳定。

这一版本的重点是强化安全性、提升性能以及优化用户体验，具体更新内容如下。

二、修复与改进

React 和 Next.js 安全升级

将 react 与 react-dom 升级至 19.2.3，修复已知的 CVE 安全漏洞。同时，Next.js 也完成了安全更新，提升前端安全性。
凭证管理优化

修复了 available_credentials 为空的问题，保证凭证的正常读取与使用。
描述长度限制

自动生成的描述会进行截断，避免超过 400 字符限制导致提交失败，从而提升提交的顺畅度。
内容类型 Charset 设置

响应内容类型中添加了 charset，保证数据格式的一致性与正确性。
Flask-Restx 属性错误修复

移除了 validate=True 参数，解决了在 flask-restx 中产生的 AttributeError。
文档处理优化

优化了 save_document_with_dataset_id 函数的性能，并修复了 DOCX 文件中外部图片导致的提取失败问题。
Token 获取优化

当 access_token 为空时，不再抛出错误，而是返回 None，提高系统容错能力。
Hit-Test 失败问题修复

针对不存在的附件 ID 导致 hit-test 失败的问题进行了修复。

三、新功能

四、测试增强

五、性能优化

六、升级指南

1. Docker Compose 部署

备份自定义 docker-compose 配置文件（可选）：

bash 复制代码

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

获取最新代码：

bash 复制代码

git checkout main
git pull origin main

停止服务（在 docker 目录执行）：

bash 复制代码

docker compose down

备份数据：

bash 复制代码

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

升级服务：

bash 复制代码

docker compose up -d

注意

如果遇到以下数据库连接错误：

复制代码

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

请使用以下命令：

bash 复制代码

docker compose --profile postgresql up -d

2. 源码部署

停止 API Server、Worker、Web 前端服务：

获取最新代码：

bash 复制代码

git checkout 1.11.1

更新 Python 依赖：

bash 复制代码

cd api
uv sync

执行数据库迁移：

bash 复制代码

uv run flask db upgrade

重新运行 API Server、Worker、Web 前端服务。

七、版本更新列表

八、总结

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

dify 1.11.1 是一次重要的版本更新，包含安全补丁、性能提升和新功能。建议用户第一时间升级，特别是涉及到安全漏洞修复的部分，对系统安全至关重要。