如何解决代码块阻塞执行问题：足球API定时任务故障排查

场景说明 #

getMatchesByFixtureId()函数由其他函数调度，每分钟从api-football接口获取指定fixture id的足球赛事实时数据。当前遇到的问题：

• console.log(1)与console.log(2)之间的状态判断代码会阻塞后续执行
• 注释这段状态判断代码后，console.log(2)与console.log(3)之间的fixture对象构建代码又会阻塞后续逻辑
• API请求本身能正常获取到正确数据

可能原因及解决步骤 #

1. API返回数据结构不匹配 #

代码中const match = response.data.response;，如果接口返回的response是数组类型（比如多个匹配结果），直接访问match.fixture会报错，导致代码卡住。

解决：

• 先打印match的结构确认类型：

  console.log(match);
  console.log('match类型:', typeof match, '是否为数组:', Array.isArray(match));
  

• 如果是数组，将状态判断里的match.fixture改为match[0].fixture（取第一个匹配结果）。

2. 状态判断代码无异常捕获 #

如果match.fixture.status.short不存在或类型异常，会直接抛出错误阻塞后续代码。

解决：
给状态判断代码加上异常捕获：

try {
  if(["CANC", "FT", "AET", "PEN", "PST", "AWD", "WO"].includes(match.fixture.status.short)){
    status = "FT";
    if(count === 4){
      request = false;
    }
    count++;
  }
  else if(["TBD", "NS"].includes(match.fixture.status.short)){
    status = "SC";
    count = 0;
  }
  else if(["HT", "LIVE", "1H", "2H", "ET", "BT", "P"].includes(match.fixture.status.short)){
    status="LIVE";
    count = 0;
  }
} catch (err) {
  console.error('状态判断出错:', err);
  status = 'UNKNOWN'; // 设置默认状态，避免后续逻辑中断
}

3. fixture对象构建逻辑存在阻塞点 #

代码中const fixture = { Bunch of data }是占位符，实际构建时可能存在：

• 引用未定义的变量导致报错
• 大量同步计算、循环等阻塞主线程的操作

解决：

• 逐步注释fixture对象中的字段，定位到具体导致阻塞的代码块
• 把同步阻塞的操作改成异步（比如大量计算可以放到worker线程）

4. 数据库操作未做异常处理 #

replaceOne操作可能因数据库连接异常、参数错误卡住，需要捕获异常避免整个任务阻塞。

解决：

try {
  await client.db("db").collection("matches").replaceOne(fixture);
} catch (dbErr) {
  console.error('数据库更新失败:', dbErr);
}

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