把业务逻辑从存储过程搬到 ORM，最常见的现象是：功能看着都通了，但报表数字对不上、分页越翻越慢、批量更新偶发死锁。问题往往不在 ORM 本身，而在中间那层数据库兼容层没设计好。
兼容层的作用，是让旧的存储过程与新的 ORM 代码在迁移期内共存，并保证同一份数据只有一套读写规则。设计得当时，迁移可以按模块分批推进；设计不当时，两套逻辑各写各的，问题只会在上线后暴露。
现象：迁移后数据对不上、性能变差
迁移期最典型的几类现象，可以先对照排查。
- 金额与汇总不一致：存储过程里用了隐式类型转换或四舍五入口径，ORM 侧按标准类型处理，差在分位。
- 查询变慢：原来在库内一次完成的关联与聚合，被拆成多次查询，或 ORM 生成了不走索引的语句。
- 偶发死锁：两套逻辑对同一批数据的加锁顺序不同，并发时互相等待。
- 空值与默认值异常：旧表允许空串、零值代表「未设置」，新代码按 null 判断，业务判断分支走错。
排查方向一：兼容层的分层边界是否清晰
建议把兼容层划成三层，职责各自独立，避免业务代码直接碰存量对象。
- 数据访问层：统一封装连接、事务与分页，ORM 与存储过程调用都从这里走，便于切换与埋点。
- 适配层：对存量存储过程做一层调用包装，对输入输出做类型与口径归一，业务代码不感知底层是哪种实现。
- 口径层：把金额精度、时间时区、枚举取值、软删除标记等约定集中定义，两套实现共用同一份规则。
排查时先确认边界有没有被绕过。若业务代码里仍能直接拼接 SQL 或直接调用存量过程，口径就注定会分叉。需要成体系的实施方案时，可以参考我们的软件定制开发与系统集成服务。
排查方向二：存储过程与 ORM 的口径差异
逐项核对是最有效的办法，重点看四类差异。
- 类型与精度：小数位、金额单位、整型溢出边界是否一致，转换发生在前端、后端还是数据库。
- 空值语义：null、空串与零值在旧逻辑中分别代表什么，新代码是否照搬。
- 排序与分页：排序字段不唯一时结果顺序不稳定，分页会出现重复或漏行，建议补上主键作为兜底排序。
- 事务边界：旧过程内部自行提交的步骤，在 ORM 的长事务中位置变了，失败回滚范围随之改变。
把每一条差异写成对照条目，迁移一个模块就核销一批，比事后靠人工比对数据可靠得多。
排查方向三：性能退化发生在哪一层
先在数据访问层记录每条语句的耗时与调用来源，再区分为三类处理。
- 把 ORM 生成的语句抓出来，与旧过程的执行路径逐条比对，确认索引是否被用上。
- 对报表类、批量类操作，评估是否保留为库内实现，通过适配层调用，不必强行改写为 ORM。
- 对关联层级深、结果集大的查询，考虑拆成明确的两次查询在应用层合并，避免出现笛卡尔放大。
判断标准很简单：能稳定走索引、结果集可控的保留 ORM；计算密集、数据量大的保留库内实现。两者并不冲突，关键是入口统一。
推荐的排查顺序
按下面顺序推进，能尽早暴露高风险问题，避免返工。
- 盘点存量对象：列出被业务调用的存储过程、视图、触发器，标注调用方与业务重要级。
- 确认口径定义：先冻结金额精度、时区、空值与状态取值，形成书面约定。
- 搭好兼容层骨架：数据访问层与适配层先行，业务代码只依赖适配接口。
- 选低风险模块试迁：以查询多、写入少的功能开路，验证口径与性能。
- 核对数据一致性：新旧实现并行跑同一批请求，比对结果集与汇总值。
- 逐步收敛存量对象：确认无调用后再下线，保留回退开关。
写入密集和涉及财务核算的模块放在后段，等口径与工具都稳定后再动。涉及流程审批的环节，通常还要与协同办公系统打通，国产 OA 的实施一般建议先梳理组织与权限，再谈数据同步。
预防措施：让迁移期可控
几条在项目中反复验证有效的做法。
- 保留回退开关：按模块配置走旧过程还是新实现，出问题能秒级切回，降低上线压力。
- 做并行比对：对新旧结果抽样比对，差异日报化，而不是等到验收才发现。
- 统一事务策略：明确哪些操作允许长事务，哪些必须拆短，避免锁等待扩散。
- 设数据守护：对关键表加约束与校验任务，及早发现脏数据而不是被动救火。
- 控制改造粒度：一个迁移批次只动有限的表与过程，评审与回滚都可控。
若重构同时涉及多种数据库并存、需要信创环境适配，兼容层的转换规则要提前下沉到口径层，不宜散落在业务代码中。我们做过的同类场景见同类项目案例，其中包含政府与制造业场景的旧系统改造。
可直接照着做的问题清单
- 存量存储过程、视图、触发器是否已完整登记并标注调用方？
- 金额精度、时区、空值语义是否有书面约定，两套实现是否共用？
- 业务代码是否还存在直接拼 SQL 或绕过适配层的调用？
- 分页查询是否带唯一排序字段，翻页结果是否稳定？
- 事务边界是否清晰，回滚范围与旧逻辑是否等价？
- 数据库账号权限是否按最小权限配置，读写是否分离？
- 新旧实现的并行比对是否已建立，差异是否可追溯到具体模块？
- 回退开关是否经过演练，切换后缓存与连接池是否需要重建？
- 上线后的运维交接是否包含兼容层的运行说明与常见故障处理？
这份清单建议在每次迁移批次开始前过一遍，结束时再核销一遍。需要结合自身系统做方案评估时，可以通过联系我们沟通具体范围与实施路径。
