n8n 2.0数据库支持变更与PostgreSQL迁移指南
1. N8N 2.0数据库支持变更的核心解读
n8n作为一款开源工作流自动化工具，其2.0版本的数据库支持策略发生了重大调整。根据官方文档，新版本将仅维护对SQLite和PostgreSQL的支持，而MySQL支持已被移出官方维护范围。这一变更主要基于以下技术考量：
- 维护成本优化：PostgreSQL和SQLite已经能够覆盖绝大多数使用场景，集中精力维护两个数据库引擎比分散支持多个数据库更有利于保证质量
- 功能完整性：PostgreSQL在复杂查询、JSON支持和事务处理方面比MySQL更具优势，更适合工作流自动化场景
- 架构简化：移除MySQL支持可以减少代码复杂度，降低未来版本升级的兼容性风险
重要提示：现有使用MySQL的n8n 1.x用户升级到2.0时，必须提前完成数据库迁移，否则将导致系统无法启动。
2. 新版数据库选型对比与配置指南
2.1 SQLite与PostgreSQL特性对比
| 特性 | SQLite | PostgreSQL |
|---|---|---|
| 适用场景 | 开发测试、单机部署 | 生产环境、团队协作 |
| 性能表现 | 轻量快速 | 高并发优化 |
| 数据容量 | 适合中小数据集 | 支持TB级数据 |
| 备份恢复 | 文件级备份 | 完善的备份机制 |
| 高可用性 | 不支持 | 支持集群部署 |
| 配置复杂度 | 零配置 | 需要单独安装配置 |
2.2 PostgreSQL详细配置步骤
对于生产环境部署，建议采用PostgreSQL作为后端数据库。以下是完整的配置流程：
安装PostgreSQL：
# Ubuntu/Debian sudo apt update && sudo apt install postgresql postgresql-contrib # CentOS/RHEL sudo yum install postgresql-server postgresql-contrib sudo postgresql-setup initdb sudo systemctl start postgresql创建专用数据库和用户：
CREATE DATABASE n8n_db; CREATE USER n8n_user WITH PASSWORD 'secure_password'; GRANT ALL PRIVILEGES ON DATABASE n8n_db TO n8n_user;配置n8n环境变量：
export DB_TYPE=postgresdb export DB_POSTGRESDB_DATABASE=n8n_db export DB_POSTGRESDB_HOST=localhost export DB_POSTGRESDB_PORT=5432 export DB_POSTGRESDB_USER=n8n_user export DB_POSTGRESDB_PASSWORD=secure_password export DB_POSTGRESDB_SCHEMA=publicTLS加密配置（可选）：
export DB_POSTGRESDB_SSL_CA_FILE=/path/to/ca.crt export DB_POSTGRESDB_SSL_REJECT_UNAUTHORIZED=true
3. 从MySQL迁移到PostgreSQL的完整方案
3.1 迁移前准备工作
备份现有数据：
- 备份n8n的MySQL数据库完整内容
- 记录当前使用的n8n版本号
- 备份
~/.n8n目录下的配置文件
环境准备：
- 安装PostgreSQL 12+版本
- 准备与MySQL字符集(utf8mb4)兼容的PostgreSQL数据库
工具选择：
- 官方推荐使用
pgloader工具进行跨数据库迁移 - 对于简单场景可使用导出CSV再导入的方式
- 官方推荐使用
3.2 使用pgloader执行迁移
安装pgloader：
# Ubuntu/Debian sudo apt install pgloader # macOS brew install pgloader创建迁移脚本
migrate.load：LOAD DATABASE FROM mysql://mysql_user:password@localhost/n8n_db INTO postgresql://n8n_user:password@localhost/n8n_db WITH include no drop, create tables, create indexes, reset sequences SET MySQL PARAMETERS net_read_timeout = '180', net_write_timeout = '180' ALTER SCHEMA 'n8n_db' RENAME TO 'public';执行迁移：
pgloader migrate.load
3.3 迁移后验证
数据完整性检查：
- 对比源库和目标库的记录数
- 抽样检查关键工作流和凭证数据
- 验证二进制数据(BLOB)的迁移结果
功能测试：
- 启动n8n 2.0并连接PostgreSQL
- 执行典型工作流测试
- 检查定时任务和历史执行记录
4. 常见问题与解决方案
4.1 迁移过程中的典型错误
问题1：字符集不兼容导致的乱码
解决方案：
- 在PostgreSQL中创建数据库时显式指定字符集：
CREATE DATABASE n8n_db WITH ENCODING 'UTF8' LC_COLLATE 'en_US.UTF-8' LC_CTYPE 'en_US.UTF-8';
问题2：自增主键序列不同步
解决方案：
- 迁移完成后重置所有序列：
SELECT setval(pg_get_serial_sequence(table_name, 'id'), (SELECT MAX(id) FROM table_name)) FROM information_schema.tables WHERE table_schema = 'public';
4.2 性能调优建议
PostgreSQL配置优化：
# postgresql.conf shared_buffers = 4GB # 25% of total RAM effective_cache_size = 12GB # 75% of total RAM maintenance_work_mem = 1GB # for index creation work_mem = 128MB # for complex queries random_page_cost = 1.1 # SSD storage max_worker_processes = 8 # parallel query max_parallel_workers_per_gather = 4 # per queryn8n专用配置：
# 增加工作流执行历史保留天数 export EXECUTIONS_DATA_SAVE_INTERVAL=7 # 限制保存的执行记录数量 export EXECUTIONS_DATA_MAX_SAVE=10000
4.3 降级回滚方案
如果迁移后遇到不可解决的问题，可以按照以下步骤回退：
- 停止n8n 2.0服务
- 恢复MySQL数据库备份
- 修改环境变量重新指向MySQL
- 降级安装n8n 1.x版本
- 验证系统功能完整性
5. 生产环境最佳实践
5.1 高可用部署架构
对于关键业务系统，建议采用以下架构：
+-----------------+ | Load Balancer | +--------+--------+ | +---------------+---------------+ | | +----------+----------+ +----------+----------+ | PostgreSQL Primary | | PostgreSQL Standby | | (Read/Write) | | (Hot Standby) | +----------+----------+ +----------+----------+ | | +---------------+---------------+ | +--------+--------+ | n8n Cluster | +-----------------+5.2 监控与维护
关键监控指标：
- 数据库连接数
- 查询响应时间
- 工作流队列长度
- 执行失败率
维护任务：
-- 定期清理历史数据 DELETE FROM execution_entity WHERE started_at < NOW() - INTERVAL '30 days'; -- 重建索引 REINDEX TABLE workflow_entity;备份策略：
# 每日全量备份 pg_dump -Fc -U n8n_user -d n8n_db -f /backups/n8n_$(date +%Y%m%d).dump # WAL归档配置 archive_mode = on archive_command = 'cp %p /backups/wal/%f'
对于需要继续使用MySQL的特殊场景，可以考虑在n8n前增加一个API抽象层，将数据访问路由到MySQL数据库。但这种方案会增加系统复杂度，仅建议作为临时过渡方案使用。