这个系列写到第四篇,前面几篇把 NestJS 的基础工程、鉴权、配置管理都跑通了,今天聊一个让不少兄弟头疼的问题:国产化项目要求数据库换成达梦,但开发环境一直是 MySQL,而且业务代码已经写了一堆,不可能推倒重来。
我接到这个需求的时候,第一反应是搜 TypeORM 有没有达梦官方 driver,搜了一圈发现——基本没有像 mysql2 那种开箱即用的东西。达梦的 Node.js 生态非常薄弱,网上能搜到的资料大多是 Java 的 JDBC 方案,偶尔有几篇 Node 的还停留在「能连上」的阶段,连分页、事务、时间字段这种常规操作都覆盖不全。
这篇文章我把整条路走了一遍之后的东西整理出来:一套 NestJS 代码,通过配置切换就能同时跑在 MySQL 和达梦上,业务层零感知。内容覆盖驱动选型、数据源动态装配、方言差异治理、以及我在实际项目中踩过的几个大坑。适合正在做信创适配的 Node 后端同学,尤其是那种客户环境已经定死达梦、但团队开发机还在用 MySQL 的项目。
1. 先搞清楚达梦在 Node 生态里的真实地位
达梦(DM)是国内用得比较多的国产关系型数据库,核心卖点是高度兼容 Oracle 语法,同时也能切到 MySQL 兼容模式。但这是站在 SQL 层面说的,跟 Node.js 能不能连上它是两回事。
1.1 Node.js 生态的现状
达梦官方的客户端驱动,在 Java 世界有 JDBC,Python 有 dmPython,.NET 有 Provider,但 Node.js 这边长期没有一等公民级的官方驱动。哪怕现在能拿到官方提供的 Node 组件,文档也少得可怜,更不用说像 mysql2 那样有完善的连接池、预处理语句、类型转换方案。
TypeORM 这边更直接,内置 driver 列表里没有达梦。这带来一个连锁反应:NestJS 文档里的标准写法 TypeOrmModule.forRoot({ type: 'mysql', ... }) 只能对付 MySQL,面对达梦你会发现自己连 type 字段都不知道填什么。
1.2 三条现实的接入路径
我调研下来发现,Node 项目接达梦基本上有三条路:
第一条:用官方或社区提供的 Node 驱动直连。 这条路最顺,但需要看达梦版本和你拿到的驱动包是否匹配。达梦 8 有一些第三方封装,但成熟度参差不齐,挑的时候要重点看它对 prepared statement、事务、BLOB 这几个硬骨头的支持程度。
第二条:JDBC Bridge 旁路。 Node 服务不直接连达梦,而是通过一个极薄的 Java 服务做 SQL 透传。这个方案看起来绕,但在信创项目里非常常见,因为客户环境里 Java 栈是主流,JDBC 驱动是最稳的。代价是多一个进程要部署和守护,网络链路多一跳。
第三条:驱动层伪装成 MySQL。 达梦兼容 MySQL 模式时,大部分 SQL 语法是接近的。于是有人选择在应用层继续用 type: 'mysql',把差异尽量收敛到 SQL 方言层。这个方案对代码侵入最小,但对团队 SQL 规范要求很高,稍不注意就会埋雷。
1.3 我的结论
我最终采用的是「官方/社区驱动直连为主,JDBC Bridge 兜底,方言差异统一收口」的组合策略。核心思路一句话:不管底层驱动是怎么连上的,上层一定要把「数据源类型」和「业务代码」彻底解耦。 业务代码永远不写 if (dbType === 'dm') 这种分支,所有差异都收口到配置层和查询构造层。
这一步想清楚了,后面所有工作都围绕这个原则展开。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 驱动接入:从「连不上」到「稳定连接」
驱动是地基,这块不踏实,后面全白搭。我建议你按下面的顺序做验证,不要一上来就接 NestJS。
2.1 环境准备
我这边客户给的是达梦 8.1,部署在麒麟 V10 上,默认端口 5236。如果你第一次接触达梦,先用达梦自带的 Manager 客户端或者 DBeaver 连一次,确认三件事:库能连、账户有权限、测试表能建。
DBeaver 连达梦需要手动加驱动,在数据库驱动管理器里新建驱动,把达梦安装目录下的 DmJdbcDriver.jar 填进去,URL 模板写 jdbc:dm://{host}:{port}。先用 DBA 账户连上去,创建项目专用的业务账号,顺手把字符集确认了。达梦默认字符集如果跟 MySQL 不一致,后面中文乱码会折腾到你怀疑人生。
2.2 官方 Node 驱动的接入体验
达梦官方在不同时期发布过 Node.js 驱动包,名称在 npm 上出现过多个版本,包名未必统一。我的建议是:优先找你们项目资料库或达梦官网开发者专区里的安装包,不要随便 npm install 一个来路不明的包,国产数据库驱动这种基础组件,来源要可信。
拿到驱动包之后,先写一个 30 行的连接测试脚本,不要直接上 TypeORM。验证四件事:
- 能建立连接并执行
SELECT 1 - 预处理语句能跑,参数占位符语法不会报错
- 事务能正常
BEGIN / COMMIT / ROLLBACK - 中文读写不乱码
这四步全部通过,驱动才算基本可用。我这边的经验是,前三步通常两天内能跑通,第四步才是真正的拦路虎,后面单独讲。
2.3 JDBC Bridge 兜底方案
如果你拿到的驱动包质量不行,或者达梦版本太老,那就走 JDBC Bridge。我设计的 Bridge 是一个 Spring Boot 小服务,只暴露内网接口,接收 SQL 和参数,内部用 JDBC 执行后返回结果集。
Bridge 接口设计成 JSON 格式,POST /query,请求体包含 sql、params、timeout 三个字段,响应统一包一层 `success / da
