将Dify数据从默认的嵌入式SQLite迁移到外部独立的PostgreSQL数据库，说起来不算复杂，但细节稍有不慎就容易踩坑。尤其是在高并发、多租户或需要生产级审计的场景下，这一步几乎是必须做的——它关乎元数据结构的完整、时区语义的一致性，以及全文索引的可重建性。下面把整个流程拆开来讲，从确认状态到最终重启，每一步都尽量说透。
确认源库状态与目标环境就绪
先进入Dify的部署目录，执行docker-compose ps，确认dify-api和postgresql容器都在Up状态。这里有个关键判断：如果当前用的是SQLite，那postgresql容器理论上不该存在或者没启动——这是迁移的前提条件。有一点必须反复强调：在开始操作之前，务必停用所有Dify服务，否则写锁一触发，数据不一致就麻烦了。
接着在Linux服务器上验证PostgreSQL实例是否可达。运行psql -h 192.168.5.100 -U dify_user -d dify_production，输入密码后出现dify_production=>提示符，说明网络和认证都没问题。
导出SQLite结构与数据
找到Dify挂载的SQLite文件路径，通常藏在./volumes/db/data/dify.db。用SQLite3命令行工具导出全量schema和数据：sqlite3 ./volumes/db/data/dify.db ".dump" > dify_dump.sql。这一步生成的SQL里包含大量的CREATE TABLE和INSERT语句，但直接拿去PostgreSQL里跑肯定报错——原因很简单，SQLite语法比较宽松（比如允许INTEGER PRIMARY KEY AUTOINCREMENT），而PostgreSQL要求显式声明SERIAL或GENERATED ALWAYS AS IDENTITY。
转换SQL语法并适配PostgreSQL特性
这里有两种方法可选。第一种是用开源工具sqlite3-to-postgres自动转换：安装后执行npx sqlite3-to-postgres --input dify_dump.sql --output dify_pg.sql --db-name dify_production。这个工具挺聪明，会自动把TEXT映射成VARCHAR(255)、BOOLEAN映射成BOOLEAN、DATETIME映射成TIMESTAMPTZ，连SQLite里的strftime函数也会替换成PostgreSQL的to_char格式。适合大多数场景。
第二种是手动修正关键字段，仅限小规模调试用。打开dify_dump.sql，搜索CREATE TABLE datasets，把id TEXT PRIMARY KEY改成id UUID PRIMARY KEY DEFAULT gen_random_uuid()；然后检查所有包含created_at的表，确保类型是TIMESTAMPTZ NOT NULL DEFAULT NOW()，而不是SQLite的TEXT。另外别忘了提前在PostgreSQL中启用pgcrypto扩展：CREATE EXTENSION IF NOT EXISTS "pgcrypto";，否则gen_random_uuid()函数不可用。
初始化目标PostgreSQL并导入数据
首先登录目标PostgreSQL，创建专用数据库和用户：CREATE DATABASE dify_production OWNER dify_user;，然后GRANT ALL PRIVILEGES ON DATABASE dify_production TO dify_user;。接着切换到新库，执行转换后的SQL文件：\c dify_production，再\i /path/to/dify_pg.sql。最后一步是校验核心表的记录数是否匹配——在SQLite里执行SELECT COUNT(*) FROM datasets;，再到PostgreSQL里跑同样的语句，结果必须完全一致。如果差一条，大概率是sqlite_sequence这个元数据表被误导入了，需要手动删掉。
更新Dify配置指向新数据库
修改.env文件中的数据库连接字符串：把原来的SQLALCHEMY_DATABASE_URI=sqlite:///./volumes/db/data/dify.db替换成SQLALCHEMY_DATABASE_URI=postgresql://dify_user:your_password@192.168.5.100:5432/dify_production。如果Dify部署在Docker里，还得同步更新docker-compose.yml里面dify-api服务的environment段，确保环境变量生效。最后重启全部服务：docker-compose down && docker-compose up -d。至此，迁移完成。