هشدار AH00161: server reached MaxRequestWorkers setting, consider raising the MaxRequestWorkers setting یعنی Apache به سقف Workerهای مجاز برای پاسخگویی همزمان رسیده است. راهحل امن، افزایش فوری و بدون محاسبه این مقدار نیست؛ ابتدا MPM فعال، وضعیت درخواستها و RAM آزاد را بررسی کنید، سپس علت طولانیشدن درخواستها را برطرف کنید یا سقف را متناسب با منابع تغییر دهید.
سناریو و پیشنیازهای عیبیابی
این راهنما برای Apache HTTP Server 2.4 روی سرور لینوکس با دسترسی مدیریتی است. قبل از تغییر فایلهای تنظیمات، پنجره نگهداری و مسیر بازگشت داشته باشید. در هاست اشتراکی ممکن است به تنظیمات MPM دسترسی نداشته باشید و باید از پشتیبانی هاست کمک بگیرید. برای نصب اولیه و شناخت ساختار سرویس، راهنمای نصب Apache در اوبونتو را ببینید.
۱. تشخیص هشدار در لاگ و بررسی MPM فعال
sudo journalctl -u apache2 --since "2 hours ago" --no-pager | grep -E 'AH00161|MaxRequestWorkers'
sudo grep -R "AH00161" /var/log/apache2/ /var/log/httpd/ 2>/dev/null | tail -n 20
apache2ctl -M 2>/dev/null | grep mpm
httpd -M 2>/dev/null | grep mpmنام سرویس و باینری به توزیع بستگی دارد: در Debian/Ubuntu معمولاً apache2 و در RHEL-based معمولاً httpd است. فقط یکی از MPMهای event، worker یا prefork باید فعال باشد. اگر هشدار در لاگ فعلی نیست، آن را با کندی سایت بهصورت خودکار یکی ندانید.
۲. بررسی Workerها، صف درخواست و فشار منابع
free -h
vmstat 1 5
ps -eo pid,comm,rss,%cpu --sort=-rss | head -n 20
sudo ss -tan '( sport = :80 or sport = :443 )' | head -n 30
sudo apache2ctl -S 2>/dev/null || sudo httpd -Sخروجی RSS در پردازشهای Apache را با احتیاط تفسیر کنید: حافظه مشترک ممکن است در جمع ساده چند بار شمرده شود. برای بررسی دقیقتر مصرف واقعی، از smem یا PSS در /proc/<pid>/smaps_rollup (در صورت دسترسی) استفاده کنید. ss فقط وضعیت اتصال را نشان میدهد و بهتنهایی تعداد درخواستهای در حال پردازش را تعیین نمیکند.
در صورت فعالبودن و محدودسازی دسترسی mod_status، نمای server-status?auto میتواند BusyWorkers، IdleWorkers و سایر شاخصها را نشان دهد. این Endpoint را عمومی نکنید؛ دسترسی را به localhost یا IP مدیریتی محدود کنید. برای آشنایی با تفاوت معماری دو وبسرور، مقایسه NGINX و Apache نیز مفید است.
۳. تنظیمات مؤثر بر MaxRequestWorkers را پیدا کنید
sudo grep -RniE '^[[:space:]]*(MaxRequestWorkers|ServerLimit|ThreadsPerChild|ThreadLimit)[[:space:]]' /etc/apache2 /etc/httpd 2>/dev/null
apache2ctl -V 2>/dev/null | grep -E 'SERVER_CONFIG_FILE|HTTPD_ROOT|Server MPM'
httpd -V 2>/dev/null | grep -E 'SERVER_CONFIG_FILE|HTTPD_ROOT|Server MPM'در MPMهای worker و event، MaxRequestWorkers سقف Threadهای پردازش درخواست است و باید با ThreadsPerChild و ServerLimit سازگار باشد. در prefork سقف تعداد پردازشهای فرزند است. افزایش بیحساب میتواند به Swap، OOM و افت شدید کارایی منجر شود. مقدار مناسب برای همه سرورها یکسان نیست.
۴. محاسبه محافظهکارانه ظرفیت و تغییر امن
ابتدا مصرف پایدار سیستمعامل، دیتابیس، PHP-FPM و سایر سرویسها را از RAM کل کسر کنید. فقط بخشی از باقیمانده را برای Apache در نظر بگیرید و حاشیه امن نگه دارید. برای prefork میتوان یک برآورد اولیه از تقسیم بودجه RAM بر مصرف تقریبی هر پردازش گرفت، اما برای MPMهای Thread-based باید سربار پردازش/Thread و حافظه اشتراکی را جداگانه اندازه گرفت؛ این فرمول، تضمین ظرفیت نیست.
از فایل تنظیمات فعال نسخه پشتیبان زماندار بگیرید و فقط همان فایل را با ویرایشگر تغییر دهید؛ مسیر دقیق را از خروجی مرحله قبل پیدا کنید:
sudo cp -a /path/to/active-mpm-config /path/to/active-mpm-config.bak-$(date +%Y%m%d-%H%M%S)
sudoedit /path/to/active-mpm-config
sudo apache2ctl configtest 2>/dev/null || sudo httpd -tهشدار: مسیر /path/to/active-mpm-config یک Placeholder است؛ آن را عیناً اجرا نکنید. نمونه تنظیم صرفاً برای نشاندادن ارتباط پارامترها در MPM event/worker است، نه مقدار پیشنهادی برای محیط واقعی:
<IfModule mpm_event_module>
ServerLimit 8
ThreadsPerChild 25
MaxRequestWorkers 200
</IfModule>برای اعمال ServerLimit یا تغییرهای MPM، ممکن است graceful کافی نباشد و Restart برنامهریزیشده لازم شود. ابتدا مستندات نسخه و MPM خود را بررسی کنید؛ در محیط پرترافیک تغییر را در زمان کمریسک انجام دهید. اگر گلوگاه اصلی درخواستهای کند، دیتابیس یا PHP باشد، صرفاً افزایش سقف مشکل را حل نمیکند.
۵. اعمال تغییر، Verify و پایش بعد از آن
sudo apache2ctl configtest 2>/dev/null || sudo httpd -t
sudo systemctl reload apache2 2>/dev/null || sudo systemctl reload httpd
sudo systemctl status apache2 --no-pager 2>/dev/null || sudo systemctl status httpd --no-pager
curl -I --max-time 10 http://127.0.0.1/در صورت تغییر ServerLimit، اعمال کامل را با Restart کنترلشده مطابق MPM و دستورالعمل عملیاتی خود انجام دهید. پس از اعمال، همزمان BusyWorkers، تأخیر پاسخ، مصرف RAM و رخداد مجدد AH00161 را در بار واقعی رصد کنید. پاسخ 200 از localhost بهتنهایی اثبات رفع مشکل در بار بالا نیست. اگر تنظیمات امنیتی یا هدرها نیز تغییر کردهاند، راهنمای تنظیم هدرهای امنیتی در Apache و NGINX را برای تست جداگانه مرور کنید.
۶. Rollback و خطاهای رایج
اگر خطای Syntax، افزایش Swap، OOM یا بدترشدن Latency رخ داد، فایل پشتیبان همان مرحله را به مسیر اصلی برگردانید، configtest بگیرید و در پنجره نگهداری Reload/Restart مناسب را انجام دهید. هرگز بدون ثبت مقدار قبلی، پارامترها را چند برابر نکنید. از اشتباههای رایج میتوان به ویرایش فایل MPM غیرفعال، نادیدهگرفتن محدودیتهای ServerLimit، فعالکردن عمومی mod_status و اشتباهگرفتن مشکل Backend با کمبود Worker اشاره کرد.
اگر Apache روی VPS خودمدیریت اجرا میشود و پس از اصلاح درخواستهای کند هنوز ظرفیت RAM/CPU پاسخگوی بار واقعی نیست، میتوان منابع پلنهای سرور مجازی وانسرور را برای تصمیم ارتقا مقایسه کرد؛ ارتقای سرور بهتنهایی کد کند یا تنظیم نادرست MPM را اصلاح نمیکند.
منابع فنی و نکات پایانی
مبنای دستورات و محدودیتها: مستندات رسمی MaxRequestWorkers و راهنمای apachectl. قبل از اجرا در Production، نسخه Apache و MPM فعال را با مستندات همان نسخه تطبیق دهید.