Nginx + PHP-FPM 架構下,PHP-FPM 進程異常退出導致 502 Bad Gateway。半夜無人值守時,需自動偵測並恢復服務。
<?php
/**
* Nginx 502 監控自動重啟腳本
* 放入 crontab 每分鐘執行: * * * * * /usr/bin/php /path/check_502.php
*/
$config = array(
'check_url' => 'https://your-domain.com/health', // 健康檢查端點
'restart_cmd' => '/usr/local/php/sbin/php-fpm restart', // 重啟命令
'timeout' => 3, // curl 連線超時
'max_checks' => 3, // 連續失敗幾次才重啟(防誤觸)
'log_file' => '/var/log/php-fpm_monitor.log',
);
function logMsg($msg, $file) {
$line = date('[Y-m-d H:i:s] ') . $msg . "\n";
file_put_contents($file, $line, FILE_APPEND | LOCK_EX);
}
$consecutiveFailures = 0;
// 讀取上次失敗計數(簡單持久化)
$stateFile = '/tmp/php_fpm_monitor_state';
if (file_exists($stateFile)) {
$consecutiveFailures = (int)file_get_contents($stateFile);
}
for ($i = 0; $i < $config['max_checks']; $i++) {
$cmd = sprintf(
'curl -s -o /dev/null -w "%%{http_code}" --connect-timeout %d --max-time %d %s 2>/dev/null',
$config['timeout'],
$config['timeout'] * 2,
escapeshellarg($config['check_url'])
);
$httpCode = trim(shell_exec($cmd));
if ($httpCode === '502') {
$consecutiveFailures++;
logMsg("Detected 502 (attempt $consecutiveFailures/{$config['max_checks']})", $config['log_file']);
} else {
$consecutiveFailures = 0; // 成功重置計數
break;
}
sleep(1); // 間隔 1 秒重試
}
// 更新狀態
file_put_contents($stateFile, $consecutiveFailures, LOCK_EX);
// 達到閾值執行重啟
if ($consecutiveFailures >= $config['max_checks']) {
logMsg("Threshold reached, executing restart: {$config['restart_cmd']}", $config['log_file']);
$output = shell_exec($config['restart_cmd'] . ' 2>&1');
logMsg("Restart output: $output", $config['log_file']);
// 重啟後驗證
sleep(3);
$verifyCode = trim(shell_exec($cmd));
if ($verifyCode !== '502') {
logMsg("Restart verified OK (HTTP $verifyCode)", $config['log_file']);
$consecutiveFailures = 0;
} else {
logMsg("Restart FAILED, still 502", $config['log_file']);
}
file_put_contents($stateFile, $consecutiveFailures, LOCK_EX);
}
不要用首頁,建立專用輕量端點:
<?php
// health.php
// 1. 檢查資料庫連線
// 2. 檢查 Redis 連線
// 3. 檢查關鍵目錄可寫
// 4. 檢查磁碟空間
// 5. 返回 JSON
header('Content-Type: application/json');
echo json_encode(array('status' => 'ok', 'time' => time()));
# 編輯 crontab
crontab -e
# 每分鐘執行(標準用法)
* * * * * /usr/bin/php /opt/scripts/check_502.php > /dev/null 2>&1
# 或使用 flock 防止重疊執行
* * * * * flock -n /tmp/check_502.lock -c '/usr/bin/php /opt/scripts/check_502.php'
# /etc/systemd/system/php-fpm-monitor.service
[Unit]
Description=PHP-FPM 502 Monitor
After=network.target
[Service]
Type=oneshot
ExecStart=/usr/bin/php /opt/scripts/check_502.php
User=root
# /etc/systemd/system/php-fpm-monitor.timer
[Unit]
Description=Run PHP-FPM monitor every minute
[Timer]
OnBootSec=1min
OnUnitActiveSec=1min
[Install]
WantedBy=timers.target
systemctl daemon-reload
systemctl enable --now php-fpm-monitor.timer
[program:php-fpm]
command=/usr/local/php/sbin/php-fpm --nodaemonize --fpm-config /usr/local/php/etc/php-fpm.conf
autostart=true
autorestart=true
startretries=3
stderr_logfile=/var/log/php-fpm.err.log
stdout_logfile=/var/log/php-fpm.out.log
upstream php_backend {
server 127.0.0.1:9000 max_fails=3 fail_timeout=30s;
# health_check interval=10s uri=/health; # Plus 版本
}
監控腳本是權宜之計,優化配置與代碼才是根治。建議兩者並行:部署監控保底,持續優化消除 502 根因。