| Performance pitfall | Read-only node replication lag: millisecond-level normally, blows up under heavy primary writes / overloaded read-only nodes / IOPS bottlenecks — read/write splitting reads stale data; strongly consistent reads must use the primary endpoint or global consistency level | All versions (MySQL/PG) | open (mechanistic) |
| Performance pitfall | Single-writer architecture: write-throughput ceiling is a single machine; adding read-only nodes only scales reads — no answer for write-intensive scale-out, only primary spec upgrades | All versions | open (by design) |
| Ops pitfall | Spec changes / version upgrades always cause connection blips: proxy and node rolling upgrades, 10–15 minutes each time, business impact <30 seconds with 1–3 connection blips; apps must have auto-reconnect, otherwise midnight upgrades = manual on-call | All versions | open (mechanistic, verified in official FAQ) |
| Ops pitfall | Old connections don't auto-rebalance after adding read-only nodes: established read/write-splitting connections won't forward requests to the new node — must drop and rebuild / restart the app; "second-level scale-out" ≠ "second-level effective" | All versions | open (verified in official FAQ) |
| Ops pitfall | Proxy disrupts DBA operational habits: pg_stat_activity / killing connections / slow-SQL location must all distinguish proxy vs direct-node connections; some users forced to build two sets — "ops proxy" + "app proxy" | PG (same for MySQL) | partially-fixed (multiple proxies can work around it, but the cognitive burden remains) |
| Ops pitfall | One-click migration / DTS migration has many pitfalls: target read-only during migration breaks logical replication slot requirements, source plugins missing on target, DTS extraction saturating source IOPS, primary-key-less tables breaking replication, missing replication-lag monitoring charts | PolarDB-PG (2025 migration cases) | partially-fixed (missing monitoring and such are fixed; DTS throttling / primary-key-less tables are inherent constraints) |
| Compatibility pitfall | MySQL advanced features and ecosystem tool limits: community-reported limits on stored procedures/triggers; pt-osc primary-replica detection parameters (e.g., recursion) unavailable — internals are physical replication, no binlog-based replication metadata | PolarDB for MySQL | open (pt-osc limit verified in official FAQ) |
| Compatibility pitfall | Oracle compatibility isn't 100%: packages like UTL_FILE need adjustments, admin command and system view names differ from native Oracle; under the "95% compatible" statement the remaining bits are the hard parts | PolarDB-O / PG ora mode | open |
| Licensing pitfall | Lightweight/self-hosted editions need a License for commercial use: PolarDB-PG lightweight edition unlicensed gets only a 30-day free trial, then throttling; xìnchuàng (IT localization) / self-hosted scenarios must budget procurement cost — "open-source" impression ≠ free commercial use | PolarDB-PG lightweight (PolarFlex stack) | open |
| Ecosystem pitfall | Self-hosted edition has a large security attack surface: third-party testing found the PolarFlex stack runs MaxScale/backup_ctl/universe all as root, proxy has a built-in superuser with plaintext password, many ports listening by default, secrets stored base64 on disk; vanilla PG has none of these | PolarDB-PG lightweight (2026-08 field test, kernel 14.20) | open |
| Ecosystem pitfall | PolarDB for MySQL kernel open-source stagnation: the ApsaraDB repo's MySQL kernel branch hasn't synced new versions for a long time, the community edition is effectively discontinued; users wanting self-host/second-development have no upstream to follow (exact discontinuation timing to-be-verified) | PolarDB for MySQL | open (exact timing to-be-verified) |
| Ecosystem pitfall | PolarDB-X open-source local deployment pitfalls: CN can't connect to DN/GMS (protocol configuration issues), many GitHub issue reports, limited official responses; poor self-hosted experience | PolarDB-X open-source edition | open |
| Cost pitfall | Hidden storage and backup costs: storage billed by actual usage, backups billed beyond free quota, storage plans region-bound with only one of each type purchasable, overage billed pay-as-you-go; "Level-1 backups cannot be disabled" = forced storage spend | All versions | open (verified in official billing docs) |
| Cost pitfall | PolarDB not cost-effective for small businesses: at equivalent specs PolarDB costs more than RDS — paying for elasticity you can't fully use = reverse payment; small-company selection-post consensus: "start with RDS, don't chase cloud-native" | All versions | open (community consensus, 2025) |