PHP-FPM: [pool www] server reached pm.max_children setting, consider raising it

So sieht die Meldung aus

[29-Oct-2026 10:14:52] WARNING: [pool www] server reached pm.max_children setting (5), consider raising it

Hä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_children ist 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

1. Aktive Pool-Einstellungen (ohne Kommentare)
   grep -hE '^(pm|pm\.[a-z_]+) *=' /etc/php/*/fpm/pool.d/*.confKopieren
2. Wie oft hat der Pool das Limit erreicht?
   journalctl -u 'php*-fpm' --no-pager | grep -c 'max_children'Kopieren
3. 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"}'Kopieren
4. Freier Speicher auf dem Server
   free -mKopieren

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.conf setzen, zusammen mit passenden pm.start_servers, pm.min_spare_servers und pm.max_spare_servers für pm = dynamic.
• Die langsamen Anfragen finden: im Pool request_slowlog_timeout = 5s und slowlog = /var/log/php-fpm-slow.log setzen 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.

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.