RuoYi-Vue项目实战：从MySQL到PostgreSQL的平滑迁移与适配指南

1. 为什么需要从MySQL迁移到PostgreSQL？

最近接手了一个老项目的重构任务，原本基于RuoYi-Vue框架的系统一直使用MySQL数据库。但在客户要求下，需要将整个系统迁移到PostgreSQL。说实话，刚开始我也觉得不就是换个数据库嘛，改改连接配置不就行了？结果实际操作起来才发现，这里面的坑还真不少。

PostgreSQL作为一款开源关系型数据库，在很多方面确实比MySQL更有优势。比如它支持更丰富的数据类型（包括JSON、数组等），事务处理更完善，还有强大的扩展能力。特别是在处理复杂查询和大数据量时，PostgreSQL的表现往往更出色。不过这些优势也带来了迁移时的适配成本，毕竟两种数据库在语法和特性上还是有不少差异的。

2. 迁移前的准备工作

2.1 环境检查与依赖调整

首先得确保开发环境已经安装了PostgreSQL。我推荐使用Docker来快速搭建环境：

docker run --name some-postgres -e POSTGRES_PASSWORD=mysecretpassword -d -p 5432:5432 postgres

接下来要在项目中添加PostgreSQL的JDBC驱动依赖。在pom.xml中添加：

<!-- postgresql --> <dependency> <groupId>org.postgresql</groupId> <artifactId>postgresql</artifactId> <version>42.5.4</version> </dependency>

这里我建议使用较新的版本，因为老版本可能会有一些兼容性问题。记得把原来的MySQL驱动注释掉或者移除。

2.2 数据库连接配置修改

RuoYi-Vue使用的是Druid连接池，我们需要修改application-druid.yml文件：

spring: datasource: type: com.alibaba.druid.pool.DruidDataSource driver-class-name: org.postgresql.Driver url: jdbc:postgresql://localhost:5432/your_database?currentSchema=public&useUnicode=true&characterEncoding=utf8 username: postgres password: your_password

这里有几个关键点需要注意：

• currentSchema参数指定了默认的schema，PostgreSQL中这个概念相当于MySQL的database
• PostgreSQL默认的端口是5432
• 字符集设置和MySQL有些不同

3. 核心组件的适配改造

3.1 Quartz调度器配置

RuoYi-Vue内置了Quartz任务调度功能，需要针对PostgreSQL进行特殊配置。在ScheduleConfig类中，找到schedulerFactoryBean方法，添加以下配置：

prop.put("org.quartz.jobStore.driverDelegateClass", "org.quartz.impl.jdbcjobstore.PostgreSQLDelegate");

这个配置告诉Quartz使用PostgreSQL专用的SQL语句来处理任务调度，避免出现语法不兼容的问题。

3.2 分页插件调整

RuoYi-Vue默认使用的是PageHelper分页插件，需要在配置文件中修改方言设置：

pagehelper: helper-dialect: postgresql reasonable: true support-methods-arguments: true

如果不做这个修改，分页查询可能会报错，因为MySQL和PostgreSQL的分页语法是不同的（LIMIT vs OFFSET）。

4. SQL语句的适配改造

4.1 函数替换

MySQL和PostgreSQL有很多函数是不同的，需要进行全局替换：

1. sysdate()→now()
2. ifnull()→coalesce()
3. date_format()→to_char()

这些替换可以通过IDE的全局替换功能批量完成，但建议替换后仔细检查，确保没有误替换。

4.2 类型处理

PostgreSQL对类型要求更严格，特别是在比较操作时：

1. 数字和字符串的比较需要显式转换：

   -- MySQL status = 0 -- PostgreSQL status = '0'

2. 数组处理也不同：

   -- MySQL的find_in_set find_in_set(#{deptId}, ancestors) -- PostgreSQL等价写法 cast(#{deptId} as varchar) = any(string_to_array(ancestors,','))

4.3 其他常见差异

1. 自增主键：PostgreSQL使用SERIAL或IDENTITY，而不是AUTO_INCREMENT
2. 引号：PostgreSQL只支持单引号表示字符串
3. 空值判断：PostgreSQL中空字符串和NULL是不同的

5. 迁移后的测试要点

完成代码修改后，必须进行全面测试。我建议重点关注以下几个方面：

1. 基础CRUD操作：确保增删改查基本功能正常
2. 事务处理：特别是跨多个表的操作
3. 复杂查询：包含子查询、连接、分组等
4. 分页功能：各种条件下的分页是否正确
5. 定时任务：Quartz调度是否正常执行
6. 性能测试：大数据量下的查询效率

6. 常见问题与解决方案

在实际迁移过程中，我遇到了不少问题，这里分享几个典型的：

1. 序列问题：PostgreSQL使用序列来实现自增，如果直接从MySQL导入数据，可能需要重置序列：

   SELECT setval('your_table_id_seq', (SELECT MAX(id) FROM your_table));

2. 时区问题：PostgreSQL的时区处理与MySQL不同，建议在连接字符串中明确指定：

   url: jdbc:postgresql://localhost:5432/your_database?currentSchema=public&useUnicode=true&characterEncoding=utf8&TimeZone=Asia/Shanghai

3. 大小写敏感：PostgreSQL默认是大小写敏感的，如果表名或列名有大写字母，查询时需要加双引号：

   SELECT * FROM "UserTable" WHERE "UserName" = 'test';

7. 数据迁移工具推荐

如果现有MySQL数据库中有大量数据需要迁移，可以使用以下工具：

1. pgloader：一个强大的数据迁移工具，支持从MySQL到PostgreSQL的迁移

   pgloader mysql://user:password@localhost/source_db postgresql://user:password@localhost/target_db

2. DBeaver：数据库管理工具，提供数据导出/导入功能

3. 自定义脚本：对于特殊需求，可以编写Python或Shell脚本来处理

8. 性能优化建议

迁移完成后，可以考虑针对PostgreSQL进行一些性能优化：

1. 索引优化：PostgreSQL的索引类型比MySQL丰富，可以根据查询模式选择合适的索引
2. 分区表：对于大表，可以考虑使用PostgreSQL的分区表功能
3. 连接池配置：根据实际负载调整Druid连接池参数
4. 查询计划分析：使用EXPLAIN ANALYZE分析慢查询

整个迁移过程虽然有些繁琐，但完成后系统的稳定性和性能确实有了明显提升。特别是在处理复杂查询和大数据量时，PostgreSQL的表现确实令人满意。