云主机使用Nginx+PHP-FPM时502错误排查清单

# 检查PHP-FPM是否运行
systemctl status php8.1-fpm  # 根据实际版本调整

# 查看进程数量（应与pm.max_children匹配）
ps -ef | grep php-fpm | wc -l

# 典型问题**：
# - 进程数达到上限（502伴随PHP-FPM日志"reached max_children"）
# - 进程崩溃（日志出现Segmentation fault）

# 检查Nginx配置中的proxy_pass或fastcgi_pass
location ~ \.php$ {
    # TCP方式（需检查端口）
    fastcgi_pass 127.0.0.1:9000;
    
    # 或Unix Socket方式（需检查权限）
    # fastcgi_pass unix:/run/php/php8.1-fpm.sock;
}

; /etc/php/8.1/fpm/pool.d/www.conf 关键参数
pm = dynamic  # 或ondemand（流量波动大时推荐）
pm.max_children = 512  # TOP云112核服务器建议值：1024-2048
pm.start_servers = 256
pm.min_spare_servers = 128
pm.max_spare_servers = 512

max_children ≈ (可用内存 - 系统预留) / 每个PHP进程内存
# 示例：128G内存服务器，每个PHP进程300M
max_children = (128*1024 - 16384) / 300 ≈ 384

# 检查当前限制
ulimit -n
cat /proc/$(pidof php-fpm | awk '{print $1}')/limits | grep "Max open files"

# 永久修改（TOP云推荐值）
echo "* soft nofile 65536" >> /etc/security/limits.conf
echo "* hard nofile 65536" >> /etc/security/limits.conf

# 检查系统级限制
sysctl net.core.somaxconn
# TOP云112核服务器建议值：8192

# 检查PHP-FPM配置
grep "listen.backlog" /etc/php/8.1/fpm/pool.d/*.conf
# 建议值：4096（需≤somaxconn）

# 查看SYN_RECV队列堆积（502前兆）
netstat -ant | grep SYN_RECV | wc -l

# 动态追踪队列溢出（需安装bcc-tools）
/usr/share/bcc/tools/tcplife -D 9000 -t 1

# 检查socket文件权限
ls -la /run/php/php8.1-fpm.sock
# 正确权限示例：srwxrwxrwx 1 webapps webapps 0 Mar 26 10:00

# 快速修复命令
chown webapps:webapps /run/php/*.sock
chmod 666 /run/php/*.sock

; 在PHP-FPM配置中启用慢日志
slowlog = /var/log/php-fpm/www-slow.log
request_slowlog_timeout = 5s  # 超过5秒的请求记录日志

# 使用pt-pmp分析PHP进程堆栈（需安装percona-toolkit）
pt-pmp $(pidof php-fpm) --save /tmp/php-stacks

// 检查PHP应用中的数据库连接配置
// 典型问题：每个请求新建连接导致PHP-FPM阻塞
$db = new PDO('mysql:host=localhost;dbname=test', 'user', 'pass', [
    PDO::ATTR_PERSISTENT => true  // 启用持久连接
]);

; 在PHP-FPM池配置中绑定CPU核心（需安装numactl）
env[NUMA_NODE] = 0  # 绑定到第一个NUMA节点
env[PHP_FCGI_CHILDREN] = 16  # 每个worker绑定16核

# 查看PHP进程的CPU亲和性
taskset -cp $(pidof php-fpm | awk '{print $1}')

# 为PHP-FPM分配大页内存（减少TLB miss）
echo 2048 > /sys/kernel/mm/hugepages/hugepages-2048kB/nr_hugepages
numactl --interleave=all php-fpm8.1 --daemonize

cat /proc/meminfo | grep Huge