When entering the container to perform the database upgrade operation, an issue occurred.

快速结论：该报错通常出现在 Dify 自托管 Docker 环境下执行数据库升级操作时，优先排查是否缺少 dify-agent 依赖包或文件路径不正确。

问题场景

用户在 Dify 1.15.0 自托管（Docker）环境中，进入容器后执行数据库升级命令时触发。

报错原文

error: Failed to generate package metadata for `dify-agent==0.1.0 @ editable+../dify-agent`
  Caused by: Distribution not found at: file:///app/dify-agent

原因分析

可能原因：Dify 容器内的 dify-agent 包以可编辑模式（editable install）安装，但实际路径 /app/dify-agent 不存在或挂载丢失，导致 Python 打包工具无法生成元数据，从而阻塞数据库升级流程。

环境排查

• 确认 Dify 版本为 1.15.0
• 确认 .env 文件中 MIGRATION_ENABLED 是否设置为 true（默认值）
• 确认 Docker Compose 配置中 dify-agent 目录是否正确挂载
• 检查容器内 /app/dify-agent 是否存在

解决步骤

1. 重新启动容器，让自动迁移机制先运行：docker compose down && docker compose up -d
2. 验证迁移日志：docker compose logs api | grep -i migration
3. 如果自动迁移已成功，数据库升级命令应可正常执行；若仍失败，请优先检查 dify-agent 包的安装路径和文件完整性
4. 如需手动执行数据库升级，请确保按正确顺序运行：docker compose exec api flask upgrade-db，随后按需运行 docker compose exec api flask backfill-plugin-auto-upgrade

验证方法

重新执行数据库升级命令，不再出现 Distribution not found 错误即表示问题已解决；也可通过查看容器日志确认迁移任务正常完成。

参考来源

langgenius/dify #38090

AI 工具推荐

想把多个 AI 模型放在一个入口？

GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型，适合写作、绘图、视频和日常 AI 工作流。

了解 GamsGo AI

推广链接：通过此链接购买，我可能获得佣金，不影响你的价格。