Pixel Streaming匹配问题：提示“无可用空Cirrus服务器”

问题核心 #

本地测试Epic官方Pixel Streaming Infrastructure时，Cirrus服务器明明满足numConnectedClients=0且ready=true的可用条件，但浏览器访问Matchmaker时仍提示WARNING: No empty Cirrus servers are available，同时发现getAvailableCirrusServer()函数既进入了符合条件的if分支，又执行了分支外的代码，导致最终返回无效结果。

可能原因及解决方法 #

1. 循环未及时终止，返回值被覆盖 #

getAvailableCirrusServer()的遍历逻辑可能存在问题：找到符合条件的服务器后没有立即终止循环，后续循环迭代或分支外代码修改了返回值，导致最终返回null。

• 修复示例：

function getAvailableCirrusServer() {
  for (const server of cirrusServers) {
    if (server.numConnectedClients === 0 && server.ready) {
      console.log("匹配到可用服务器：", server.id);
      return server; // 找到后立即返回，终止循环
    }
  }
  console.log("无可用服务器");
  return null;
}

检查原函数是否在return后还有未终止的逻辑，或者循环中没有正确跳出，这是最常见的导致分支执行异常的原因。

2. 服务器状态异步更新不同步 #

ping消息日志显示的状态是历史值，getAvailableCirrusServer()执行时内存中的服务器状态还未完成更新，导致判断逻辑失效。

• 解决方法：
  • 确保ping消息处理函数在更新服务器状态变量后，没有异步延迟；
  • 在getAvailableCirrusServer()执行前，强制拉取最新的服务器状态，避免使用缓存数据。

3. 通信链路存在隐性异常 #

虽然Matchmaker、SignallingWebServer、Unreal实例显示连接正常，但可能存在WebSocket消息丢失或端口/协议不匹配的情况，导致Matchmaker未正确接收Cirrus的状态更新。

• 解决方法：
  • 核对Matchmaker配置里的cirrusEndpoint是否和SignallingWebServer的实际监听地址完全一致；
  • 查看Matchmaker控制台日志，排查是否有WebSocket连接断开、消息解析失败的报错。

4. 变量作用域错误导致判断失效 #

getAvailableCirrusServer()中可能误用了全局变量或外部作用域的变量，导致状态判断时引用的不是当前遍历的服务器实例。

• 解决方法：检查函数内的变量声明，确保cirrusServer是循环内的局部实例，而非外部作用域的变量。

验证步骤 #

1. 在getAvailableCirrusServer()的if分支内添加日志，记录当前服务器的ID、numConnectedClients和ready状态；
2. 在函数末尾添加日志，记录最终返回的结果；
3. 触发浏览器匹配请求时，对比控制台日志，看是否存在“符合条件的服务器被找到，但最终返回null”的情况，定位问题环节。

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