→ سیستم‌نامه

max_connections در برابر max_user_connections: چرا وردپرس همچنان Too Many Connections می‌دهد

3 دقیقه مطالعهآخرین بروزرسانی: سپتامبر 8, 2026

وقتی وردپرس همچنان «Too Many Connections» می‌دهد در حالی که سرور MySQL خالی و بی‌کار به نظر می‌رسد — و تفاوتی که هیچ‌کس بهت نمی‌گوید: max_connections در برابر max_user_connections.

مسئله از کجا شروع می‌شود؟

یک فروشگاه بزرگ WooCommerce هر از گاهی با خطای اتصال به دیتابیس مواجه می‌شد. اولین سوالی که همه می‌پرسند این است: «MySQL پره؟» ولی حدس زدن به جایی نمی‌رسد؛ باید خطای واقعی را دید. برای همین یک لاگر اختصاصی (db-error.php) نصب شد تا هر بار خطای دیتابیس رخ داد، متن دقیق آن ثبت شود، نه فقط یک پیام کلی روی صفحه‌ی سفید مرگ.

خطای واقعی که ثبت شد این بود:

errno=1226
User 'h415632_db' has exceeded the 'max_user_connections'
current value: 30

چرا این خطا گمراه‌کننده است

وقتی این پیام را می‌بینی، فرض طبیعی این است که کل سرور MySQL به سقف ظرفیتش رسیده. برای همین وضعیت کلی سرور هم چک شد:

Max_used_connections = 445
max_connections      = 2000
Threads_connected    ≈ 27 تا 33
Threads_running      = 4

یعنی خودِ سرور MySQL هیچ مشکلی نداشت — هنوز فرسنگ‌ها با سقف ۲۰۰۰ فاصله داشت. مشکل جای دیگری بود: هاست، برای اکانت دیتابیس وردپرس (نه کل سرور)، یک سقف جداگانه و بسیار کوچک‌تر گذاشته بود — همان max_user_connections که مقدارش فقط ۳۰ بود. این دو عدد کاملاً مستقل از هم‌اند:

max_connections سقف کل اتصالات همزمان به کل سرور MySQL است، برای همه‌ی یوزرها و همه‌ی دیتابیس‌ها روی آن هاست.
max_user_connections سقفی است که می‌تواند فقط روی یک اکانت دیتابیس خاص (یک یوزر MySQL) گذاشته شود، مستقل از اینکه بقیه‌ی سرور چقدر خلوت یا شلوغ باشد.

می‌شود یک سرور با max_connections=2000 داشت که هنوز فقط ۴۵۰ تا از آن استفاده شده، ولی یک اکانت دیتابیس مشخص روی همان سرور، با محدودیت ۳۰تایی خودش را، مدام خطای اتصال بدهد. وردپرس در این حالت همان پیام «Too many connections» یا خطای errno 1226 را نشان می‌دهد، و کسی که فقط وضعیت کلی سرور را چک کند، نتیجه می‌گیرد «سرور که مشکلی نداره، پس باید یه جای دیگه ایراد داشته باشه» — در حالی که ایراد دقیقاً همین‌جاست، فقط لایه‌ی اشتباهی چک شده.

راه‌حل

وقتی موضوع به هاست گزارش شد، آن‌ها هم تأیید کردند: به‌خاطر مصرف بالای MySQL، اکانت دیتابیس محدود (Restrict) شده بوده. آن‌ها فعلاً سقف max_user_connections را به ۲۰۰ افزایش دادند — که خودش فقط یک مُسکّن موقت است، نه رفع ریشه‌ای؛ ریشه‌ی واقعی مصرف بالا جای دیگری بود (که در مقاله‌های بعدی این مجموعه بررسی شده: فشار ناشی از یک کراولر توزیع‌شده روی صفحات فیلتر ووکامرس، و مشکل کش که باعث می‌شد حتی درخواست‌های ساده‌ی صفحه‌ی اصلی هم مستقیم به دیتابیس بخورند).

نتیجه

وقتی وردپرس خطای اتصال دیتابیس می‌دهد، چک کردن فقط max_connections و Threads_connected کافی نیست؛ باید مستقیماً خطای واقعی MySQL را با یک لاگر اختصاصی دید، و اگر errno مربوط به connection بود، حتماً max_user_connections همان اکانت دیتابیس را هم جداگانه چک کرد. این دو عدد در دو لایه‌ی کاملاً متفاوت زندگی می‌کنند، و اشتباه گرفتنشان می‌تواند ساعت‌ها وقت را صرف دنبال کردن سرنخ غلط کند.

SOS سایتت خوابیده؟