NGINX Unit中PHP进程重启时Memcached连接数异常问题分析

问题现象

在使用NGINX Unit运行PHP应用时，发现每当Unit重启PHP工作进程后，会出现Memcached客户端库(libmemcached)的断言错误。错误信息表明Memcached服务器数量超过了系统预设的最大限制(MEMCACHED_CONTINUUM_SIZE)。

技术背景

NGINX Unit采用进程管理机制，当PHP工作进程达到预设的请求处理上限(通过applications..limits.requests配置)后，会自动重启进程。这种机制保证了应用长期运行的稳定性，防止内存泄漏等问题。

libmemcached是PHP Memcached扩展的底层库，它使用一致性哈希算法来分布键到不同的Memcached服务器。该算法需要为每个服务器创建一定数量的虚拟节点(MEMCACHED_POINTS_PER_SERVER)，总节点数不能超过MEMCACHED_CONTINUUM_SIZE的限制。

问题根源

经过分析，发现问题出在PHP进程重启时Memcached连接的处理方式上：

1. 当Unit创建新的PHP工作进程时，会从原型进程(prototype process)派生
2. PHP的Memcached扩展可能保留了之前进程的连接状态
3. 新进程再次添加相同的Memcached服务器，导致服务器计数不断增加
4. 最终服务器数量×每个服务器的虚拟节点数超过了MEMCACHED_CONTINUUM_SIZE限制

解决方案

在PHP代码中初始化Memcached连接时，应先调用resetServerList()方法清除可能存在的服务器列表，然后再添加新的服务器连接。例如：

$memcached = new Memcached();
$memcached->resetServerList();  // 清除已有服务器列表
$memcached->addServers([['memcached', 11211]]);  // 添加新服务器

这种方法确保了每次进程重启时都从干净的连接状态开始，避免了服务器列表的重复累积。

深入分析

虽然问题表现为libmemcached的断言错误，但根本原因在于PHP扩展与Unit进程管理机制的交互方式。Unit的进程派生机制本身是正确的，问题出在：

1. PHP Memcached扩展可能在共享内存或全局变量中维护了连接状态
2. 这些状态在进程派生时被保留下来
3. 新进程再次初始化时没有正确清理这些状态

这种现象也提醒我们，在使用持久化连接或全局状态时，需要特别注意与进程管理系统的兼容性。

最佳实践建议

1. 对于使用Unit运行的有状态PHP应用，应在初始化代码中加入状态清理逻辑
2. 定期检查第三方扩展的兼容性，特别是那些维护全局状态的扩展
3. 合理设置Unit的进程请求限制，平衡性能与稳定性
4. 在开发环境中模拟生产环境的进程管理行为，提前发现类似问题

通过采用这些措施，可以确保应用在Unit的高效进程管理下稳定运行，同时充分利用Memcached等外部服务的性能优势。