So sieht die Meldung aus
[29-Oct-2026 10:14:52] WARNING: [pool www] server reached pm.max_children setting (5), consider raising itHäufige Ursachen
- Langsame Skripte halten Worker lange besetzt: eine langsame Datenbankabfrage, eine langsame externe API, eine Sperre.
- Ein Verkehrsschub oder Bots treffen ungecachte PHP-Seiten.
pm.max_childrenist für die normale Last dieses Servers schlicht zu niedrig.- Der Wert wurde früher zu hoch gesetzt, PHP erschöpft nun den RAM, und Worker werden beendet (siehe die OOM-Seite).
- Lang laufende Anfragen wie Exporte oder Importe blockieren Worker.
Prüfen
- Aktive Pool-Einstellungen (ohne Kommentare)
grep -hE '^(pm|pm\.[a-z_]+) *=' /etc/php/*/fpm/pool.d/*.conf - Wie oft hat der Pool das Limit erreicht?
- Durchschnittlicher Speicher pro PHP-FPM-Worker
ps -eo rss,cmd | awk '/[p]hp-fpm: pool/ {s+=$1; n++} END {if (n) print n " Worker, " s/n/1024 " MB Durchschnitt"}' - Freier Speicher auf dem Server
free -m
Lösung
- Den Pool nach Speicher dimensionieren:
pm.max_children= RAM, den du PHP geben kannst, geteilt durch die durchschnittliche Worker-Größe aus der Prüfung oben. - In der Pool-Datei unter
/etc/php/<Version>/fpm/pool.d/www.confsetzen, zusammen mit passendenpm.start_servers,pm.min_spare_serversundpm.max_spare_serversfürpm = dynamic. - Die langsamen Anfragen finden: im Pool
request_slowlog_timeout = 5sundslowlog = /var/log/php-fpm-slow.logsetzen und die Stack-Traces lesen. - Die Last senken: Seiten cachen, missbräuchliche Bots sperren, lange Jobs aus Web-Anfragen auslagern.
- Den PHP-FPM-Dienst deiner Version neu starten und das Log auf die Warnung beobachten.
Typisches Szenario
Ein WooCommerce-Shop auf einem VPS mit 4 GB RAM läuft normalerweise problemlos. Bei einer Rabattaktion häufen sich im PHP-FPM-Log Zeilen „server reached pm.max_children setting (5)“, die Seiten laden zäh und nginx liefert vereinzelt 504. Der Pool steht noch auf dem Paket-Standard mit fünf Workern. Miss zuerst, wie viel Speicher ein Worker im Mittel braucht, und ermittle daraus, wie viele Worker auf den Server passen.
Häufige Fragen
Kann ich pm.max_children einfach sehr hoch setzen?
Nein. Jeder Worker braucht Speicher. Übersteigt die Summe den RAM, beendet der Kernel Prozesse oder der Server swappt, das ist schlimmer als wartende Anfragen.
Welchen pm-Modus soll ich nutzen?
dynamic ist ein guter Standard. ondemand spart RAM auf ruhigen Servern, ist aber bei ersten Anfragen langsamer, static eignet sich für ausgelastete Server mit planbarem Speicher.
Wie sehe ich, wie viele Worker gerade beschäftigt sind?
Aktiviere im Pool pm.status_path = /fpm-status und stelle die Seite nur lokal bereit. Sie zeigt aktive und wartende Prozesse, die Länge der Warteschlange („listen queue“) und „max children reached“, also wie oft das Limit schon erreicht wurde. Ein Zähler größer als 0 bestätigt das Problem.
Hilft ein höheres pm.max_children, wenn die Datenbank langsam ist?
Eher nicht. Mehr Worker bedeuten mehr gleichzeitige Datenbankabfragen, was eine ohnehin überlastete Datenbank noch langsamer macht. Dann behebst du zuerst die langsame Abfrage oder den Engpass, etwa mit dem Slow-Query-Log, und erhöhst das Limit erst danach maßvoll.
Wie senke ich die Last, ohne mehr Worker einzusetzen?
Mit einem Seiten-Cache für anonyme Besucher, etwa FastCGI-Cache in nginx oder einem Cache-Plugin. Gecachte Seiten kommen ohne PHP aus, sodass die Worker für Warenkorb und Kasse frei bleiben. Bots lassen sich zusätzlich mit Rate-Limits oder in der robots.txt bremsen.