多进程下单例“唯一性”彻底失效，因fork后各子进程内存隔离，静态变量self::$instance为独立副本，spl_object_id不同且PDO/Redis连接句柄失效；正确做法是按getmypid()隔离连接、状态交由Redis等外部存储协调。

多进程下单例“唯一性”彻底失效

PHP 的 pcntl_fork() 或常驻脚本启动多个 worker 进程时，每个子进程会完整复制父进程的内存空间。静态变量 self::$instance 在子进程中是独立副本，不是共享引用。这意味着：

父进程调用 getInstance() 创建实例 A，子进程调用后创建的是完全无关的实例 B

spl_object_id() 值不同，=== 比较为 false

若单例封装了 MySQL/Redis 连接，多个进程共用同一连接句柄会触发 "MySQL server has gone away" 或 "read error on connection" 错误

错误写法：忽略进程隔离，直接复用静态实例

这是最典型也最危险的写法——把单例当成跨进程全局对象来用：

1. class DB { 
2.     private static $instance = null; 
3.     private $pdo; 
4.  
5.     private function __construct() { 
6.         $this->pdo = new PDO(...); // 连接在 fork 后被复制，但底层 socket 句柄无效 
7.     } 
8.  
9.     public static function getInstance() { 
10.         if (self::$instance === null) { 
11.             self::$instance = new self(); 
12.         } 
13.         return self::$instance; 
14.     } 
15. } 

问题在于：子进程里调用 getInstance() 得到的 $pdo 对象，其内部 socket 资源已被父进程关闭或处于不可用状态，后续 query 必然失败。

错误写法：未隔离连接句柄，复用同一连接池

有些实现试图“优化”，在单例中缓存连接，但没按进程区分：

用 md5(serialize($config)) 作连接缓存 key，却没加入 getmypid()

Redis 客户端复用同一个 Redis 实例，而该实例内部 socket 在 fork 后无法跨进程使用

MySQL 使用持久连接（pconnect）仍会出错，因连接归属权未重置

根本原因：操作系统层面，fork 后子进程继承的是文件描述符的副本，而非共享句柄；一旦父进程关闭连接或超时，子进程的副本即失效。

正确思路：按进程隔离 + 外部协调

单例在多进程里无法真正“跨进程唯一”，只能做到每进程内唯一 + 状态可协调：

连接类必须按进程 ID 隔离：构造连接句柄时，key 中强制包含 getmypid()，确保每个进程独享连接实例

共享状态走外部存储：如用 Redis 存储锁、计数器、配置快照等，单例只负责读写这个外部介质，不自己维护跨进程状态

避免在单例中持有 PHP 原生资源（如 PDO、Redis、cURL handle），改由每次请求按需初始化或通过进程安全的连接池管理

例如修复 MySQL 单例：

1. private static function getHandleKey($params) { 
2.     if (PHP_SAPI === 'cli') { 
3.         $params['pid'] = getmypid(); // 关键：绑定当前进程 
4.     } 
5.     ksort($params); 
6.     return md5(implode('_', $params)); 
7. } 

Tags: PHP单例模式 PHP多进程单例失效

分享到：