SQL 查询升级：用回归样本确认语义没有变化
升级数据库版本、ORM 或 SQL 写法时，风险通常不是语法报错，而是排序、空值和时间函数的默认行为发生变化。升级计划要以一套稳定的查询回归样本为中心，先证明结果语义未变，再讨论性能收益。
把高风险查询列出来
优先收集包含分页排序、日期截断、窗口函数、json 字段和复杂连接的查询。每条查询配一组最小数据：空值、重复排序键、跨日时间、字符大小写差异和无匹配关联。记录旧版本的结果行、字段类型和顺序；这些内容比单纯保存 SQL 文本更能发现兼容问题。
例如分页查询若只按创建时间排序，在同一秒写入多条记录时会出现重复或漏行。升级前应补上稳定的次级键，并用连续翻页的样本验证没有重叠。日期函数则要固定会话时区，否则测试环境与生产环境可能得到不同的月边界。
分阶段切换而非一次替换
先在影子环境执行新查询，结果写入对比表，不服务真实用户。差异按类别展示：行数不同、值不同、类型不同或排序不同。允许的差异必须在变更说明中列出，例如修正历史 bug；未登记的差异一律暂停扩大范围。
切换时保留能够快速回到旧连接或旧 SQL 的开关，并避免新版本先写入旧版本无法读取的结构。索引和参数配置的调整要独立发布，否则结果问题与性能问题会互相干扰排查。
完成检查
在灰度租户上核对关键报表、导出和 API 分页；同时观察慢查询数量、锁等待和错误码。把数据库版本、客户端驱动版本、测试数据摘要和差异结论归档。升级窗口指定观察人和停止条件：出现未登记差异或锁等待持续异常，就停止扩大范围并切回旧路径。
完成切换后执行恢复演练，验证旧配置仍能启用，连接池参数能回滚，缓存中不会保留新旧语义混杂的结果。回退可以执行，才是能用于生产的回退方案。
数据迁移若涉及字符集或排序规则，回归样本应包含不同语言文本与大小写相近的值。排序改变不一定触发错误，却会破坏分页和报表排名。把这些结果作为断言，比依赖人工目测更可靠。
升级结束后清理影子环境中的对比数据和临时账号，并确认备份策略仍覆盖新版本生成的对象。收尾工作被忽略时，临时环境很容易成为长期权限风险。
针对 SQL 方言差异，还应检查保留字、默认隔离级别和错误码映射。应用代码可能没有直接拼接 SQL，却会依赖驱动返回的异常类型。用一组故意触发约束冲突和超时的测试，确认调用方仍能给出正确处理。
版本记录中写下不可逆的迁移步骤和恢复方式。即使当前不计划回滚，维护者也应知道哪些操作需要先从备份恢复，不能误以为开关能覆盖所有变更。
升级清单
- 确认驱动和数据库版本组合
- 确认日期函数的时区处理结果
- 确认排序规则不会破坏分页
- 确认约束异常仍能被正确识别
- 确认影子对比数据已经清理
- 确认备份能够恢复新产生对象
切换结束后安排一次正式复盘。
复盘结论同步到下一次升级计划。
