【实践】若依框架轻量化改造：从MySQL到SQLite3的迁移实战
1. 为什么选择SQLite3替代MySQL
若依框架作为国内流行的快速开发平台，默认采用MySQL作为数据库。但在某些特定场景下，MySQL显得过于"重量级"：比如开发演示环境、资源受限的嵌入式设备、快速原型验证等。这时候SQLite3的优势就凸显出来了：
- 零配置部署：不需要安装数据库服务，一个文件就是完整数据库
- 单文件存储：所有数据、表结构、索引都保存在单个.db文件中
- 跨平台性强：数据库文件可以在不同操作系统间直接拷贝使用
- 资源占用低：运行时内存消耗通常只有几百KB
我在最近的一个物联网项目中就遇到了这种情况：需要在树莓派上部署若依的管理后台，但设备只有1GB内存。将MySQL换成SQLite3后，内存占用直接减少了70%，完美解决了资源瓶颈问题。
2. 迁移前的准备工作
2.1 环境检查清单
开始迁移前，建议先准备好以下环境：
- JDK 1.8+（实测OpenJDK 17也能完美运行）
- Maven 3.6+（避免使用旧版导致构建问题）
- 若依基础项目（推荐4.7.5版本）
- SQLite3命令行工具（用于数据库初始化）
# 快速检查环境是否就绪 java -version mvn -v sqlite3 --version2.2 项目结构调整
若依默认的多模块结构对SQLite3迁移不太友好，建议先做精简：
- 保留ruoyi-admin核心模块
- 移除ruoyi-quartz定时任务模块（首次迁移时可暂不考虑）
- 清理不需要的MySQL驱动依赖
注意：如果项目已经深度定制，建议先创建一个新的分支进行迁移实验
3. 关键配置修改步骤
3.1 数据库连接配置
找到application-druid.yml文件，主要修改三个关键配置：
spring: datasource: driver-class-name: org.sqlite.JDBC url: jdbc:sqlite:/path/to/ruoyi.db druid: validation-query: SELECT 1 FROM DUAL这里有个大坑需要注意：SQLite的JDBC驱动在验证连接时，必须存在DUAL表。解决方法是在初始化脚本中加入：
CREATE TABLE DUAL(test int); INSERT INTO DUAL VALUES(1);3.2 POM依赖调整
在ruoyi-admin的pom.xml中，替换MySQL依赖为SQLite3驱动：
<dependency> <groupId>org.xerial</groupId> <artifactId>sqlite-jdbc</artifactId> <version>3.43.2.2</version> </dependency>建议使用3.36.0.1以上版本，旧版存在日期解析问题。我在实际项目中就踩过这个坑，系统日志里的时间全部变成乱码，升级驱动后才解决。
4. SQL脚本转换实战
4.1 基础语法转换
若依提供的SQL脚本需要做以下适配修改：
| MySQL语法 | SQLite3等效写法 |
|---|---|
AUTO_INCREMENT | AUTOINCREMENT |
ENGINE=InnoDB | 直接删除 |
DEFAULT NULL | 可省略 |
COMMENT '注释' | -- 注释 |
4.2 典型问题处理
分页语句改造： 若依的PageHelper插件需要特殊配置：
pagehelper: helper-dialect: sqlite日期函数替换： 将所有sysdate()替换为CURRENT_TIMESTAMP，我在迁移用户表时就因为漏改这个导致注册时间全部出错。
索引语法调整：
-- MySQL写法 ALTER TABLE `sys_user` ADD INDEX `idx_dept_id` (`dept_id`); -- SQLite3写法 CREATE INDEX IF NOT EXISTS idx_dept_id ON sys_user(dept_id);5. MyBatis映射文件适配
5.1 常见SQL差异处理
若依的XML映射文件中需要特别注意这些MySQL特性：
LIMIT分页参数：
<!-- 原MySQL写法 --> <if test="pageNum != null and pageSize != null"> LIMIT #{pageNum},#{pageSize} </if> <!-- SQLite3兼容写法 --> <if test="pageNum != null and pageSize != null"> LIMIT #{pageSize} OFFSET #{pageNum} </if>ON DUPLICATE KEY UPDATE替换：
-- 使用SQLite的INSERT OR REPLACE语法 INSERT OR REPLACE INTO sys_config (...) VALUES (...)5.2 批量插入优化
MySQL的批量插入语法：
INSERT INTO table VALUES (1),(2),(3);SQLite3需要改为：
INSERT INTO table VALUES (1); INSERT INTO table VALUES (2); INSERT INTO table VALUES (3);我在迁移菜单数据时就遇到这个问题，最后写了个Python脚本自动转换插入语句。
6. 迁移后的验证与调试
6.1 常见错误排查
日期格式问题： 如果遇到Unparseable date错误，检查驱动版本是否≥3.36.0.1，并在连接URL添加参数：
jdbc:sqlite:test.db?date_string_format=yyyy-MM-dd HH:mm:ss事务锁定问题： SQLite的写操作会锁定整个数据库，建议调整若依的批量操作逻辑，改为小批量多次提交。
6.2 性能调优建议
- 启用WAL模式提升并发：
PRAGMA journal_mode=WAL;- 调整缓存大小：
PRAGMA cache_size=-2000; -- 2MB缓存- 定期执行
VACUUM命令整理数据库碎片
7. 生产环境注意事项
虽然SQLite3很轻量，但在生产环境使用时仍需注意：
- 备份策略：SQLite没有网络服务，需要自行实现.db文件备份
- 并发限制：写操作是串行的，高并发场景要考虑队列机制
- 数据迁移：后期如果需要切回MySQL，可以使用
.dump命令导出SQL
我在一个边缘计算项目中就采用了每日定时压缩备份.db文件的方案，用简单的crontab任务就实现了数据安全：
# 每天凌晨备份 0 0 * * * sqlite3 /app/ruoyi.db ".backup /backups/ruoyi_$(date +%Y%m%d).db"这种轻量化改造后的若依框架，特别适合作为演示系统、内网工具或资源受限环境的管理后台。整个迁移过程最耗时的其实是SQL语法转换环节，建议先在小规模测试库上验证所有功能再正式切换。