CentOS下Gearman PHP客户端无法连接服务的问题解决

核心错误定位 #

从报错信息里的127.0.0.1:4730:4730 getaddrinfo:Name or service not known可以直接看出问题：PHP代码中调用GearmanClient::addServer()时错误地重复指定了端口，导致客户端无法正确解析Gearman服务地址，最终出现GEARMAN_NO_SERVERS错误。

具体解决步骤 #

1. 修复PHP代码中的addServer调用 #

打开/gearman/gearmanManager.class.php第28行，检查addServer的写法：

• 错误写法示例（端口拼在地址里，或参数传递错误）：

  $client->addServer('127.0.0.1:4730');
  // 或者错误传递两个端口参数
  $client->addServer('127.0.0.1', '4730:4730');
  

• 正确写法（主机和端口分开传递，默认端口4730可省略）：

  // 指定主机和端口
  $client->addServer('127.0.0.1', 4730);
  // 或使用默认端口时简化写法
  $client->addServer('127.0.0.1');
  

2. 验证Gearman服务的监听状态 #

执行以下命令确认gearmand是否在预期端口正常监听：

netstat -tulpn | grep gearmand
# 或使用ss命令（CentOS 7+推荐）
ss -tulpn | grep gearmand

正常输出应该包含0.0.0.0:4730或127.0.0.1:4730，表示服务正在监听。如果没有输出，检查gearmand启动日志（通常在/var/log/messages或/var/log/gearmand.log）排查启动失败原因，比如端口被占用。

3. 修复后测试连接 #

重新运行myClientProgram.php，确认不再出现GEARMAN_NO_SERVERS警告。再执行状态检查命令：

gearadmin --status | sort -n | column -t

正常情况下会显示已注册的Worker、任务队列的待处理/正在执行数量，而非仅显示一个"dot"。

4. 额外排查（若上述步骤无效） #

• SELinux限制：CentOS默认SELinux可能阻止PHP（Apache/FPM）发起网络连接，执行以下命令检查并开启权限：

  # 检查当前状态
  getsebool -a | grep httpd_can_network_connect
  # 若为off，永久开启
  setsebool -P httpd_can_network_connect on
  

• 版本兼容性：确认libgearman库、gearmand服务与PHP的gearman扩展版本匹配，避免因版本差异导致的连接问题。

内容的提问来源于stack exchange，提问作者Abhinav