3331
MySQLERRORNotableInnoDB / PerformanceHIGH confidence
InnoDB I/O capacity exceeded
Production Risk
High — write performance degrades; transactions may stall.
How to reproduce
trigger — this will error
trigger — this will error
-- Typically manifests during heavy write workloads, not from a single statement.
expected output
ERROR 3331 (HY000): InnoDB: I/O capacity exceeded.
Fix
Increase I/O capacity settings
Increase I/O capacity settings
SET GLOBAL innodb_io_capacity = 2000; SET GLOBAL innodb_io_capacity_max = 4000;
Why this works
Higher values allow InnoDB to flush dirty pages faster, keeping the I/O queue from backing up.
What not to do
✕
Sources
Official documentation ↗
MySQL 8.0 — 3331 ER_INNODB_IO_CAPACITY_EXCEEDED
Content generated with AI assistance and reviewed for accuracy. Found an error? hello@errcodes.dev