PHP-FPM的pool配置文件默认位于Ubuntu/Debian的/etc/php/8.2/fpm/pool.d/www.conf，宝塔环境则在/www/server/php/82/etc/php-fpm.conf的[www]段内；修改后须systemctl reload php8.2-fpm或systemctl restart php-fpm-82生效。
确认 PHP-FPM 的 pool 配置文件位置
PHP 8.2 的 pool 配置默认不在 php-fpm.conf 主文件里，而是单独放在 /etc/php/8.2/fpm/pool.d/www.conf（Ubuntu/Debian）或 /www/server/php/82/etc/php-fpm.conf（宝塔）。别一上来就改主配置——90% 的人配错，就是因为没找对地方。
用这个命令快速定位：
ls -l /etc/php/8.2/fpm/pool.d/
如果看到 www.conf，说明走的是系统原生路径；如果是宝塔环境，ls /www/server/php/82/etc/ 下大概率只有 php-fpm.conf，且 [www] 块就在它里面。
- Ubuntu/Debian：编辑
/etc/php/8.2/fpm/pool.d/www.conf - 宝塔：编辑
/www/server/php/82/etc/php-fpm.conf，直接在[www]段内加配置 - 编译安装：看 configure 时指定的
--with-fpm-conf路径，通常在/usr/local/php/etc/php-fpm.conf
修改 pm（进程管理）参数要按内存来算，不是拍脑袋
pm = dynamic 是生产环境唯一合理的选择。静态模式（pm = static）容易把服务器拖垮，而按需伸缩的动态模式必须配对四个关键参数，否则高并发下会频繁触发 server reached pm.max_children 警告。
立即学习“PHP免费学习笔记（深入）”；
假设你有 4GB 内存、跑一个中等流量网站：
-
pm.max_children = 50（每个 PHP-FPM 子进程约占 120–150MB） -
pm.start_servers = 5（启动时预建进程数） -
pm.min_spare_servers = 3（空闲最少保底数） -
pm.max_spare_servers = 10（空闲最多不超此数，避免资源浪费）
别抄网上“max_children=200”这种答案——没监控就盲目拉高，OOM killer 会直接 kill 掉 fpm 进程，现象是 Nginx 报 502 且日志里只有 connect() to unix:/run/php/php8.2-fpm.sock failed，根本看不出内存问题。
加环境变量必须写进 pool 段，且注意宝塔和系统路径差异
想让 PHP 脚本读到 $_ENV['ALIBABA_CLOUD_ACCESS_KEY_ID']？不能往 php.ini 里塞，也不能在 Nginx 的 fastcgi_param 里传——必须在 pool 配置块里用 env[KEY] = "value"。
Ubuntu 系统示例（在 www.conf 里）：
[www] user = www-data group = www-data listen = /run/php/php8.2-fpm.sock env[ALIBABA_CLOUD_ACCESS_KEY_ID] = "xxx" env[ALIBABA_CLOUD_ACCESS_KEY_SECRET] = "yyy"
宝塔示例（在 /www/server/php/82/etc/php-fpm.conf 的 [www] 段内）：
[www] user = www group = www listen = /tmp/php-cgi-82.sock env[APP_ENV] = "production"
验证是否生效：放个 phpinfo.php，搜索 ALIBABA_CLOUD_ACCESS_KEY_ID。没出现？八成是重启错了服务——Ubuntu 是 systemctl restart php8.2-fpm，宝塔是 systemctl restart php-fpm-82，名字差一个短横线就白忙。
socket 权限和用户组不一致，502 就静默发生
fastcgi_pass unix:/run/php/php8.2-fpm.sock; 这行本身没错，但 socket 文件权限不对，Nginx 就连不上。核心就三点：
- 确认
listen.owner和listen.group和 Nginx 的user指令一致（比如都是www-data） - 确认
listen.mode = 0660（不是 0600，否则 Nginx 组成员无法写） - 确认 socket 文件实际属主：
ls -l /run/php/php8.2-fpm.sock，输出应类似srw-rw---- 1 www-data www-data
常见坑：改完 www.conf 忘了 reload fpm，或者改了 listen.mode 却没重启 fpm——socket 文件权限不会自动更新，得重启服务重生成 socket。
最麻烦的是混合用户场景：Nginx 用 nginx 用户，而 fpm 用 www-data。这时要么把 nginx 加进 www-data 组（usermod -a -G www-data nginx），要么统一改成同一用户。别指望靠 chmod 777 解决——Unix socket 不吃那一套。
