Node.js ERR_HTTP_HEADERS_SENT错误：getRandomFood函数修复求助

遇到错误：node:internal/errors:490 ErrorCaptureStackTrace(err); Error [ERR_HTTP_HEADERS_SENT]

以下是getRandomFood异步函数代码：

getRandomFood : async (req,res) =>{
    try {
        let randomFoodList=[];
        console.log(req.params.code);
        if(req.params.code){
            randomFoodList = await Food.aggregate([
                {$match : {code : req.params.code}},
                {$sample : {size : 3}},
                {$project : {__v:0}}
            ])
        }
        console.log(randomFoodList+"Pankaj");
        if(!randomFoodList.length){
            randomFoodList = await Food.aggregate([
                {$sample : {size : 3}},
                {$project : {__v:0}}
            ])
        }
        if(randomFoodList.length){
        res.status(200).json(randomFoodList);
        return;
        }else{
        res.status(404).json({status:false,message: 'No Food Found  '});return;}
    } catch (error) {
        res.status(500).json(error);        }
    },

尝试修改所有响应返回逻辑，但函数仍无法正常返回数据且程序崩溃。另有一个函数出现相同错误，其余函数运行正常。请问需要修改代码中的哪些部分才能解决问题？

ERR_HTTP_HEADERS_SENT错误的核心原因是同一请求中多次向客户端发送响应，按以下几点修改代码：

• 统一响应逻辑，确保单次响应
  把最后一段的条件判断简化，将return与响应语句合并，确保发送响应后直接终止函数执行，避免进入后续可能触发重复响应的代码：

  // 替换原有的if-else分支
  if (randomFoodList.length) {
      return res.status(200).json(randomFoodList);
  }
  return res.status(404).json({ status: false, message: 'No Food Found' });
  

• 给code参数加非空校验
  原代码中如果req.params.code是空字符串（比如参数存在但值为空），会触发无效的匹配查询。补充非空判断，避免不必要的数据库请求：

  if (req.params.code && req.params.code.trim()) {
      randomFoodList = await Food.aggregate([
          {$match : {code : req.params.code.trim()}},
          {$sample : {size : 3}},
          {$project : {__v:0}}
      ]);
  }
  

• 错误处理分支添加return
  原catch块没有终止函数，若后续存在其他代码，可能导致重复响应，补充return：

  catch (error) {
      return res.status(500).json(error);
  }
  

• 排查路由后续逻辑
  如果修改后仍报错，检查该路由是否挂载了额外的中间件，或者全局错误处理逻辑中是否存在重复发送响应的情况，确保整个请求生命周期内仅发送一次响应。

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