| Ops pitfalls | Many components (TiDB/PD/TiKV/TiFlash/TiCDC/DM/BR/TiUP); steep conceptual learning curve (Region/Raft/TSO/MVCC/Placement Rules); slow DBA onboarding | All versions | open |
| Ops pitfalls | Before v6.5, TiCDC frequently lagged/OOMed; gc-ttl defaults to 24h — if replication is interrupted beyond that, the changefeed goes failed and unrecoverable; must be recreated | Mainly <v6.5 | partially-fixed (improved in v7.5+) |
| Ops pitfalls | TiCDC checkpoint advancement follows the weakest-stave rule — if any Region's ResolvedTs stalls, global replication lag rises; slow Regions are hard to troubleshoot | All versions | open |
| Ops pitfalls | Slow BR snapshot backups (community case: daily backups >8h, cluster load +30% during backup, application RT rises); restores saturate cluster resources — must restore to a new/offline cluster | All versions | partially-fixed (50%+ backup efficiency improvement in v7.5+; restore hogging resources remains an architectural reality) |
| Ops pitfalls | In-place upgrades don't support rollback, long jitter; major versions must be upgraded incrementally; upgrades may stall (plugin loading / kill -9 / DDL owner changes — dedicated section in the official FAQ) | All versions | open (community mainstream switched to "migration-based upgrades" at the cost of double the machines) |
| Ops pitfalls | The optimizer may pick wrong plans after upgrades (v7.5 full-scan-gravitation case: 21.5-billion-row table, 60s timeout on full scan, 0.4s with forced index) | v7.5.x | partially-fixed (solvable via SPM bindings) |
| Performance pitfalls | Single-node/small-scale performance clearly below MySQL (community-tested read-heavy: -58% to -81%) — fixed architectural cost that tuning can't erase | All versions | open (inherent to the architecture) |
| Performance pitfalls | TSO becomes the bottleneck under high-frequency small transactions (acknowledged in official tuning docs); mitigations are all "downgrades" (low-resolution TSO / merging transactions / parallel RPC) | All versions | partially-fixed |
| Performance pitfalls | RocksDB write stall → flow control rejects writes (ServerIsBusy); before v5.2 writes were rejected outright, after that delayed/partially rejected by threshold | All versions | partially-fixed (v5.2+ flow-control mechanism) |
| Performance pitfalls | AUTO_INCREMENT tail hotspots; oversized SHARD_ROW_ID_BITS amplifies RPC/CPU | All versions | partially-fixed (AUTO_RANDOM is the officially recommended replacement) |
| Compatibility pitfalls | No stored procedures/triggers/events/full-text indexes/GIS/XA/CTAS/SKIP LOCKED, etc. (official docs list each item) | All versions | open |
| Compatibility pitfalls | Foreign key constraints long an experimental feature, less mature than MySQL | v6.x+ | open (GA progress to-be-verified) |
| Compatibility pitfalls | 6MB per row / 100MB default per-transaction limit; large-transaction ETL must be split into batches | All versions | partially-fixed (v8.0 bulk DML bypasses the limit) |
| Compatibility pitfalls | DDL pitfalls: decimal precision can't be altered, metadata locks block DDL, stale schema versions raise 8027 | All versions | open |
| Cost pitfalls | High hardware bar (TiKV requires NVMe SSDs; officially recommended minimum 8 cores / 32GB+); 3-replica storage redundancy; small deployments are overkill | All versions | open |
| Ecosystem pitfalls | No Oracle compatibility — unsuitable for "de-O" (Oracle replacement) scenarios; PG-ecosystem users face rewrites too | All versions | open |