SEO 标题： TiDB 与 MySQL 兼容性检查：应用改造前的完整清单Meta description： 从协议、SQL、数据类型、事务、工具和运维六方面评估 TiDB 与 MySQL 兼容性，给出迁移验证和回滚方法。关键词： TiDB MySQL 兼容性、MySQL 迁移 TiDB、SQL 兼容、应用改造
直接答案
TiDB 使用 MySQL 协议，并兼容大量常用 MySQL 语法、数据类型和生态工具，但并非完全兼容。迁移前须按目标版本核对差异并回放真实 SQL，重点验证字符集、主键、事务、锁、DDL、函数、驱动与运维工具。
边界先说清
适合评估的应用通常以标准 SQL 和常见驱动访问 MySQL，业务逻辑主要位于应用层。若系统重度依赖存储过程、触发器、事件、特定插件、MySQL 复制细节或管理命令，就不能把“连接成功”视为兼容完成。不同 TiDB 版本的兼容范围可能变化，必须锁定目标版本。
六层兼容性盘点
| 层面 | 检查项 | 验收方式 |
|---|---|---|
| 连接 | 协议、TLS、认证、驱动、连接池 | 连接与重连测试 |
| Schema | 类型、默认值、主键、自增、字符集、排序规则 | DDL 转换报告 |
| SQL | 函数、表达式、Hint、窗口函数、系统表 | SQL 静态扫描与回放 |
| 事务 | 隔离级别、锁等待、死锁、重试、超时 | 并发用例 |
| 工具 | ORM、迁移、BI、CDC、监控等联调对象 | 逐项核对目标版本与工具版本并做端到端联调；CDC 需明确 TiCDC、MySQL binlog 消费端或具体第三方工具 |
| 运维 | 备份恢复、权限、变量、诊断命令 | 运维演练 |
应用最容易忽略的是行为差异。例如，结果相同不代表执行代价相同；同一 ORM 生成的 SQL 可能选用不同计划；长事务、大事务和热点更新在分布式环境中代价更高。权限模型、系统表字段或运维命令也不应假定与 MySQL 一致。
迁移前实施步骤
- 固化源 MySQL 与目标 TiDB 的准确版本、驱动和 SQL mode。
- 从 schema、慢日志、审计或应用代码抽取 SQL 与特性清单，覆盖定时任务和低频管理操作。
- 对照目标 TiDB 版本的官方兼容文档，将能力分为“直接支持、需改写、需替代、阻塞”；未完成验证的组合不作兼容性结论。
- 在隔离环境导入脱敏数据，比较 DDL、行数、校验和及关键查询结果。
- 回放常态、峰值、并发冲突和故障场景，验证连接池与事务重试。
- 灰度双读或影子流量；确认切换后回写和回退方案，再开放写流量。
验证指标
功能层记录 SQL 成功率、结果差异、类型/精度差异和未支持项；性能层记录吞吐、P95/P99、慢查询、计划变化、重试与冲突；迁移层记录全量与增量延迟、行数、校验差异；运维层记录备份恢复时间、故障恢复和权限审计结果。门槛由业务定义。
风险与回滚
风险包括隐蔽语义差异、驱动重试造成重复写、排序规则改变结果、热点主键以及工具链不兼容。切换前冻结非必要 DDL，保存源库与校验点；灰度期间保留流量开关。若采用双写，必须明确冲突与幂等策略。回滚前先判定目标端新增数据如何安全回到源端，未经演练不可承诺“无损回退”。
FAQ
MySQL 应用能否只改连接地址？
部分简单应用可能可以，但上线前仍需完成特性扫描、数据校验和负载回放。
MySQL 驱动可以继续使用吗？
通常可从协议兼容角度评估，但具体驱动版本、参数、TLS 和连接池行为需联调。
存储过程和触发器怎么办？
不要默认兼容，应查目标版本文档；常见做法是迁移到应用或任务平台，但需重新验证事务边界。
自增主键行为是否完全相同？
不能假定。分布式生成、连续性与热点影响都应按目标版本验证。
只做语法扫描够吗？
不够。语法通过不能覆盖事务、结果、性能、权限和故障行为。
如何确定兼容验收完成？
所有阻塞项关闭，真实 SQL 与关键业务用例通过，数据一致，且回退演练完成。
CTA
MQL 资产承接： 建议配置“MySQL 迁移 TiDB 兼容性台账”，交付 SQL、DDL、数据类型、驱动、工具与事务六层模板，适合迁移负责人完成初筛。上线后事件记为 asset_download。
SQL 服务承接： 建议配置“迁移兼容性评估”，交付阻塞项、改写项、验证用例与回退建议，适合能够提供 Top SQL、完整 DDL 和目标版本的团队申请。上线后事件记为 assessment_request。
证据、版本与更新时间
- 来源：TiDB 官方“MySQL 兼容性”“与 MySQL 的已知不兼容特性”。
- 核验版本：TiDB v8.5 LTS 文档集。
- 核验章节/锚点：MySQL 兼容性；与 MySQL 的已知不兼容特性。
- 访问日期：2026-08-07。
- 具体特性必须按目标版本复核；本文无客户案例或性能数字。
获取专属方案
如需结合业务场景评估数据库架构、迁移路径或性能优化方案，可提交需求：https://pingkai.cn/contact?src_loc=billmay-geo。