1. 项目缘起当“国产化”成为必答题最近两年但凡做企业级应用开发的同行应该都绕不开“国产化”这三个字。它不再是新闻里的远景规划而是实实在在落到我们肩上的开发任务。我手头负责的一个核心业务系统基于经典的SpringBoot Vue前后端分离架构后端是RuoYi-Vue框架数据库原本跑在MySQL上。随着项目进入“信创”改造清单技术栈的全面国产化适配就成了必须啃下来的硬骨头。这次迁移的目标很明确将整套系统从原有的“MySQL Redis CentOS”技术栈平滑迁移到国产化环境具体来说就是操作系统换成麒麟或统信UOS数据库换成达梦DM缓存中间件也需要寻找合适的国产替代方案。整个过程远不止是换个数据库驱动那么简单它涉及到驱动兼容、SQL语法适配、框架配置调整、部署环境变更等一系列连锁反应。今天这篇记录我就把从评估、改造到上线的完整过程以及踩过的那些“坑”和最终验证有效的方案做一个详细的复盘。如果你也正面临类似的国产化迁移希望这篇近万字的实操笔记能给你提供一个清晰的路线图。2. 迁移全景图目标环境与技术选型剖析在动手写一行代码之前搞清楚我们要迁移到哪里去以及新环境有什么特点是避免后期反复折腾的关键。这次迁移并非简单的“一对一”替换而是一个技术生态的切换。2.1 目标环境定义从开源生态到信创体系我们的目标生产环境是某国产化服务器搭载麒麟V10操作系统。与熟悉的CentOS相比麒麟V10同样基于Linux内核但在软件包管理yum/dnf vs apt、系统路径、依赖库版本上存在差异。这意味着我们原先写好的部署脚本、依赖的系统命令如netstat,lsof路径可能需要调整。更重要的是所有第三方软件都必须使用支持ARM或飞腾等国产CPU架构的版本。数据库层面我们选择了达梦数据库DM8。达梦作为国内老牌的商用数据库语法上高度兼容Oracle这与我们之前使用的MySQL在诸多细节上截然不同。比如分页查询、日期函数、自增主键的实现方式都有很大区别。缓存方面原先的Redis暂无完全对等的国产直接替代品但存在一些开源或商业的、兼容Redis协议的国产内存数据库如腾讯云的Tendis开源版已停止演进或一些基于Redis源码自主演进的分支。我们的策略是优先评估协议的兼容性确保业务代码改动最小。2.2 技术栈映射与风险评估基于以上目标我们绘制了详细的技术栈映射表原组件目标替代组件迁移风险等级核心关注点MySQL 5.7达梦数据库 DM8高SQL语法兼容性、事务隔离级别、JDBC驱动稳定性、性能差异Redis 6.x兼容Redis协议的国产缓存中协议兼容度尤其是集群、事务命令、数据持久化方式、性能表现CentOS 7麒麟 V10低系统命令、文件路径、依赖库安装、防火墙配置OpenJDK 8麒麟/统信定制JDK 8低JVM参数兼容性、国密算法支持NginxNginx (国产化平台编译版)低模块兼容性、SSL证书配置风险等级为“高”的数据库迁移是整个项目的核心。我们提前识别出几个关键风险点SQL方言差异项目中使用了大量MyBatis的XML编写SQL其中包含MySQL特有的函数如DATE_FORMAT,IFNULL、分页语法LIMIT以及ON DUPLICATE KEY UPDATE这类语法。框架兼容性RuoYi-Vue框架本身是否与达梦JDBC驱动完美配合特别是其内置的代码生成器、数据权限过滤模块都可能依赖特定的数据库元数据查询方式。事务与锁达梦默认的事务隔离级别与MySQL可能不同在高并发场景下需要验证。2.3 工具链准备工欲善其事必先利其器在开发测试阶段搭建一个贴近生产环境的沙箱至关重要。我们准备了以下工具达梦数据库客户端官方提供的DM管理工具和DBeaver。DM管理工具功能全面但偶尔卡顿DBeaver作为通用工具连接达梦需要安装驱动但进行日常查询和导出导入非常方便。建议两者配合使用。数据库连接工具除了DBeaver我们也测试了Navicat 16。新版本的Navicat已经内置了达梦连接支持图形化操作体验很好适合不习惯命令行和专用工具的同事。测试环境使用Docker快速部署达梦数据库的官方镜像。达梦提供了官方的Docker镜像这对于开发人员本地搭建测试环境非常友好避免了复杂的安装过程。命令大致如下docker run -d -p 5236:5236 --name dm8 \ -v /opt/dm8/data:/opt/dm8/data \ dm8_single:v8注意达梦默认端口是5236数据目录需要持久化挂载。3. 攻坚克难数据库层适配实战详解数据库迁移是工作量最大、最易出错的部分。我们的策略是“先连接再跑通后优化”。3.1 驱动引入与基础连接配置第一步是让SpringBoot应用能够连上达梦数据库。RuoYi-Vue基于SpringBoot数据源配置在application-druid.yml中。引入JDBC驱动达梦的JDBC驱动DmJdbcDriver18.jar需要手动引入项目。不建议使用Maven中央仓库可能存在的旧版本最好从达梦安装目录的/drivers/jdbc下获取或从官方渠道下载。我们将JAR包放入项目的lib目录并在pom.xml中通过system作用域引入。dependency groupIdcom.dameng/groupId artifactIdDmJdbcDriver18/artifactId version8.1.1.49/version !-- 版本号根据实际获取的驱动确定 -- scopesystem/scope systemPath${project.basedir}/lib/DmJdbcDriver18.jar/systemPath /dependency注意system作用域的依赖在打包时需要注意maven package默认不会将其打入JAR包。我们需要在SpringBoot的maven插件中显式配置includeSystemScope为true或者更推荐的做法是将驱动JAR安装到本地Maven仓库后再以普通依赖引入。修改数据源配置# application-druid.yml spring: datasource: druid: driver-class-name: dm.jdbc.driver.DmDriver url: jdbc:dm://192.168.1.100:5236/SYSDBA?zeroDateTimeBehaviorconvertToNulluseUnicodetruecharacterEncodingutf-8 username: SYSDBA password: SYSDBA123这里有几个关键点driver-class-name必须准确无误。url中的参数达梦的JDBC URL格式与MySQL不同。zeroDateTimeBehavior等MySQL特有的参数达梦驱动可能会忽略但写上一般也不会报错。更重要的参数可能是schema达梦的用户和模式SCHEMA概念与Oracle类似连接后需要访问正确模式下的表。连接池配置适配Druid连接池本身是数据库无关的但一些验证查询validationQuery需要修改。达梦的验证查询通常使用SELECT 1 FROM DUAL。dual表在达梦中也存在。spring: datasource: druid: validation-query: SELECT 1 FROM DUAL3.2 SQL语法兼容性改造“深水区”连接成功后运行应用大量的SQL异常就会扑面而来。这是最耗时的环节需要逐条分析修改。我们建立了SQL对照表来系统化处理。MySQL语法达梦等价语法/解决方案说明与示例分页 LIMITROW_NUMBER() 或LIMIT ... OFFSET(DM8支持)MySQL:SELECT * FROM t ORDER BY id LIMIT 10 OFFSET 20达梦兼容写法SELECT * FROM t ORDER BY id LIMIT 20, 10(注意顺序相反)或标准写法SELECT * FROM (SELECT t.*, ROW_NUMBER() OVER (ORDER BY id) rn FROM t) WHERE rn BETWEEN 21 AND 30IFNULL(expr1, expr2)NVL(expr1, expr2)直接全局替换。达梦也支持IFNULL但NVL是更通用的Oracle风格函数。DATE_FORMAT(date, format)TO_CHAR(date, format)MySQL:DATE_FORMAT(create_time, %Y-%m-%d)达梦:TO_CHAR(create_time, yyyy-mm-dd)注意格式符完全不同NOW()SYSDATE获取当前系统时间。ON DUPLICATE KEY UPDATEMERGE INTO 语句这是改造难点。需要将单条INSERT的冲突更新重写为MERGE语句。自增主键AUTO_INCREMENTIDENTITY(1,1)建表时列定义改为ID INT IDENTITY(1,1)。在MyBatis插入后获取自增ID达梦驱动支持Statement.RETURN_GENERATED_KEYS。GROUP_CONCATLISTAGG或WM_CONCATMySQL:GROUP_CONCAT(name SEPARATOR ,)达梦:LISTAGG(name, ,) WITHIN GROUP (ORDER BY id)或WM_CONCAT(name)(旧函数)FIND_IN_SET自定义函数或改写逻辑达梦没有内置此函数。通常需要避免数据库层处理逗号分隔字符串或在应用层处理。万不得已可在达梦中创建自定义函数。反引号 双引号 或 去掉达梦使用双引号来引用标识符如表名、列名。MySQL中用于避免关键字冲突的反引号在达梦SQL中需要去掉或改为双引号但通常如果标识符不是关键字直接去掉即可。实操心得分页改造RuoYi-Vue后台使用的PageHelper插件其达梦方言dialect配置至关重要。在application.yml中配置pagehelper.helper-dialect: dm。但要注意PageHelper的版本必须支持达梦方言否则需要升级或寻找兼容版本。日期处理坑日期比较和运算要小心。达梦的日期加减使用date interval 1 day而非MySQL的DATE_ADD。所有在SQL中进行的日期格式化、计算最好都复查一遍。MyBatis XML扫描我们写了一个简单的Python脚本扫描所有*Mapper.xml文件找出使用了LIMIT、IFNULL、DATE_FORMAT等关键字的SQL进行第一轮批量替换和标记大大提高了效率。但批量替换后必须人工复核尤其是格式符复杂的日期函数。3.3 框架级适配RuoYi-Vue的特别处理RuoYi-Vue框架本身也有一些地方需要调整数据源监控Druid监控界面可能因为SQL语法问题无法正常显示一些监控信息如“SQL监控”中的SQL语句。只要基础连接和业务SQL正常这属于非阻塞性问题可以暂时忽略。代码生成器RuoYi自带的代码生成器其数据库元数据查询语句是针对MySQL的。需要修改生成器模块中的GenTableMapper.xml将其中的information_schema.tables和information_schema.columns查询改为达梦的系统表查询如SYS.DBA_TABLES、SYS.DBA_TAB_COLUMNS需要DBA权限或USER_TABLES、USER_TAB_COLUMNS当前用户模式。这是一个比较细致的改动如果不用代码生成器可以跳过。数据库初始化脚本如果项目有schema.sql或data.sql用于启动时建表需要将其中所有的MySQL语法重写为达梦语法。4. 缓存与部署国产化环境下的最后一块拼图数据库搞定后缓存和部署环境的适配相对轻松但仍有细节需要注意。4.1 Redis国产化替代方案选型我们评估了几种方案直接使用开源RedisARM版在ARM架构的国产服务器上编译安装Redis。这是改动最小、最稳定的方案但严格意义上不符合“国产化软件”的要求可能无法满足某些测评指标。使用兼容Redis协议的国产软件如腾讯云早期开源的Tendis混合存储版或一些国产厂商基于Redis 6.0/7.0源码分支演进的产品。这些产品通常宣称完全兼容Redis协议和API。使用其他国产内存数据库如华为的GaussDB(for Redis)但这类产品通常是云服务私有化部署成本较高。考虑到项目周期和稳定性我们最终选择了方案一作为过渡即在麒麟系统上编译安装Redis 6.2.6。编译过程与在CentOS上无异tar -xzvf redis-6.2.6.tar.gz cd redis-6.2.6 make -j$(nproc) make install关键在于需要确保服务器上安装了gcc、make等编译工具链。麒麟系统可以使用apt或yum视版本而定安装。踩坑记录如果选择方案二务必进行完整的兼容性测试。我们曾测试某款兼容产品发现其对于Redis Cluster的某些命令如CLUSTER SLOTS支持不完整导致使用Jedis Cluster客户端的应用无法正常工作。因此如果业务中使用了Redis高级特性事务、Lua脚本、集群、Stream必须进行针对性测试。4.2 SpringBoot项目配置调整缓存客户端如Spring Boot的spring-boot-starter-data-redis配置基本无需改动只需确保application.yml中的host和port指向新的Redis服务地址即可。连接池如Lettuce或Jedis的配置也通用。4.3 国产化操作系统部署注意事项将打好包的应用JAR或WAR部署到麒麟服务器上整体流程与Linux无异但有几个细微差别JDK路径国产操作系统可能预装了定制版的JDK其安装路径可能与/usr/java或/usr/lib/jvm不同。需要在启动脚本中明确指定JAVA_HOME。# 在 start.sh 中 export JAVA_HOME/opt/kylinsoft/jdk8 nohup $JAVA_HOME/bin/java -jar your-app.jar app.log 21 文件权限与用户避免使用root用户直接运行应用。创建专门的appuser并确保其对应用目录、日志目录有读写权限。防火墙麒麟系统可能使用firewalld或ufw记得开放应用端口如8080和数据库端口5236。服务化管理使用systemd来管理应用服务是最佳实践。编写一个your-app.service文件放在/etc/systemd/system/下可以方便地设置开机自启、服务状态监控。5. 全链路测试与性能调优所有组件适配完成后必须进行严格的全链路测试包括功能、性能、稳定性。5.1 功能回归测试基础CRUD对所有业务模块的增删改查接口进行测试重点验证改造过的SQL功能如分页查询是否正确、日期查询是否准确、包含复杂条件的查询是否正常。事务测试模拟高并发下的数据更新验证事务的ACID特性在达梦上是否得到保障。特别是涉及金额、库存等敏感数据的业务。缓存一致性测试验证数据库更新后缓存是否能正确失效或更新。检查是否存在脏读现象。5.2 性能基准对比在同等硬件条件下我们对关键业务接口和复杂查询进行了迁移前后的性能对比测试。测试场景MySQL环境 (平均响应时间)达梦环境 (平均响应时间)分析单表主键查询15ms18ms差异不大在可接受范围。多表关联分页查询220ms350ms达梦稍慢。分析执行计划发现达梦对复杂SQL的优化器选择可能与MySQL不同需要针对性优化索引或SQL写法。大数据量插入1000条/秒800条/秒插入性能略有下降。调整达梦的BUFFER、SESSION参数后提升至约950条/秒。缓存读取1ms1ms无变化。性能调优方向达梦参数调优根据服务器内存调整达梦的MEMORY_POOL、BUFFER等内存相关参数。MAX_SESSIONS和MAX_SESSION_STATEMENT需要根据应用连接数合理设置。SQL优化利用达梦的执行计划分析工具在管理工具中查看慢SQL的执行计划。重点关注全表扫描、索引失效的情况。达梦的Hint语法如/* INDEX(table_name index_name) */也可以用来强制索引。连接池配置适当调整Druid连接池的maxActive、minIdle等参数避免连接数不足或过多。5.3 稳定性与监控系统上线后需要建立新的监控基线数据库监控监控达梦数据库的磁盘空间、内存使用率、活跃会话数、锁等待情况。达梦自身提供了一些系统视图如V$SYSSTAT,V$LOCK可供查询。应用监控通过Spring Boot Actuator、Prometheus Grafana监控应用的健康状态、JVM内存、GC情况以及关键业务指标。日志分析确保应用日志、达梦数据库日志位于安装目录的log文件夹下被妥善收集和分析便于问题排查。6. 总结与避坑指南回顾整个国产化迁移过程从最初的焦虑到最终的系统平稳运行可以说是一次深刻的技术栈升级历练。最大的体会是国产化迁移技术上的适配只是第一步思维上的转变和知识体系的更新更为重要。几条核心避坑建议测试驱动尽早介入不要等到所有代码都改完再测试。应该搭建好达梦测试环境后立即启动核心业务流程的测试尽早暴露SQL兼容性问题。建立SQL对照知识库将遇到的每一个语法差异都记录下来形成团队内的知识库。这能极大提升后续类似项目的效率。关注框架的“数据库方言”像MyBatis Plus、PageHelper、Sharding-JDBC等框架都有对应的数据库方言配置。务必确认你使用的版本是否支持达梦dm并正确配置。慎用数据库高级特性在迁移初期尽量将业务逻辑向标准的、通用的SQL靠拢避免使用数据库特有的高级函数或语法糖。如果非用不可一定要做好封装便于未来再次迁移。性能测试要有针对性不能假设达梦和MySQL性能表现一致。对于核心的、复杂的查询必须在达梦环境下重新进行性能测试和优化。备份备份备份在进行任何数据迁移或结构变更前务必做好完整的数据备份。达梦的DMRMAN工具或dexp/dimp命令行工具是备份恢复的利器要提前熟悉。国产化是一条必经之路这个过程虽然充满挑战但也是团队梳理技术债务、优化系统架构的好机会。把这次迁移中积累的经验、脚本和配置文档化会成为团队宝贵的技术资产。最后保持耐心遇到问题多查阅达梦的官方文档虽然体验可能不如MySQL社区那么丰富多与同行交流总能找到解决方案。