2025年11月26日，Dify 正式发布 1.10.1 版本，这次更新不仅带来了重大功能增强和稳定性修复，更标志着 Dify 进入了 多数据库新时代 —— MySQL 支持终于到来，并与 PostgreSQL、OceanBase 一起形成完整的多数据库体系。

🚀 新功能亮点

1. 基础设施与 DevOps 升级

• MySQL 适配完成：现在 PostgreSQL / MySQL / OceanBase 均已全面支持。
• 新增 DB_TYPE 配置选项，用于选择数据库类型。
• 支持 MySQL 特有的 JSON / LONGTEXT / UUID / 索引差异。
• Alembic 迁移脚本更新，适配多数据库兼容性。
• 引入跨数据库 SQL 辅助方法，优化统计与日期处理。
• 数据集元数据过滤重写，使用 SQLAlchemy JSON 操作符。
• 新增 MySQL 迁移测试 CI 工作流。

这一改动是 Dify 后端架构的重要里程碑，多数据库支持首次成为一等公民。

2. 性能与工作流编辑器优化

• 工作流编辑器性能显著提升：去除了高成本的逐节点验证，减少不必要渲染，性能从 50 节点变卡到接近 200 节点仍保持流畅。

3. 工作流引擎与界面优化

• 改进了工作流编辑器 UI、稳定性、交互体验，包括变量检查、媒体组件、节点交互优化。

---

🛠 修复与改进

运行时与工作流执行稳定性

• 修复高级聊天工作流无法正确停止的问题，避免进程被卡住。
• 修复草稿模式下运行任意节点会触发 500 错误的情况，提升调试稳定性。
• 修正循环/迭代评估时的令牌统计错误（不涉及计费）。
• 修复工作流作为工具返回空文件字段的问题。
• 解决 FileService 会话作用域导致文件删除异常的问题。

知识库

• 修复使用 weightedScore 检索选项时触发 500 错误的问题，恢复加权排名稳定性。

开发体验与 SDK

• 修复 Node.js SDK 路由与 multipart 上传的处理问题，保证文件与数据提交稳定性。
• 修复 OpenAPI/Swagger 加载失败的问题，恢复开发文档访问。

Web UI 与用户体验

• 修复暗色模式下 ExternalDataToolModal 渲染不一致的问题。
• 优化 Marketplace 搜索触发与滚动行为。
• 修复查看 chatflow 日志详情时导航不正确的问题。
• 修复 README 显示面板的排版与渲染问题。
• 减少 useNodes hook 的多余渲染，提升前端性能。

插件与集成

• 更新插件验证逻辑，改为使用唯一标识符，保证安装与更新的正确性。

系统健壮性

• 防止 TriggerProviderIdentity 中出现可空标签，避免运行时错误。
• 优化无效 webhook 请求的错误提示，更清晰定位问题。

反馈与日志

• 修复点赞/点踩反馈在日志中不显示的问题。

国际化 (i18n)

• 统一触发与计费事件的术语。
• 修复执行相关翻译缺失或错误的问题。
• 删除错误的“running”翻译条目。
• 重构 i18n 脚本并移除过期翻译键。
• 增补缺失翻译，提升多语言覆盖率。

维护与开发工具链

• 新增前端自动化测试规则。
• 升级系统库与 Python 依赖，保持安全性与兼容性。
• 更新启动脚本使用 pnpm dev，简化贡献者开发流程。

---

📦 升级指南

Docker Compose 部署重要提示

从 1.10.1 开始，Dify API 镜像默认以 非 root 用户（UID 1001） 运行，提升安全性。
如果使用本地文件系统存储（社区版默认），需要在升级前调整挂载目录的所有权，否则容器无法读写文件。

受影响服务：

• api
• worker

受影响目录：

• ./volumes/app/storage → /app/api/storage

升级前执行：

docker compose down
sudo chown -R 1001:1001 ./volumes/app/storage
docker compose up -d

错误提示

如遇到数据库连接错误（db_postgres hostname 解析失败），需要使用以下命令替代：

docker compose --profile postgresql up -d

源码部署步骤

# 停止服务
git checkout 1.10.1
cd api
uv sync
uv run flask db upgrade
# 重新启动 API、Worker 和前端

---

📊 总结

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

Dify 1.10.1 是一次里程碑版本，特点包括：

• 多数据库支持全面落地，MySQL 成为新成员。
• 工作流编辑器性能显著提升。
• 大量稳定性修复与前后端性能优化。
• 更安全的非 root 容器运行模式。