Rust单元测试：HTTP服务handler调用执行到末尾卡住无返回

核心可能原因 #

绝大多数情况是异步运行时的调度被阻塞，或者函数实际并未真的完成返回（输出缓冲导致的假象），常见触发点如下：

• 异步上下文内调用了同步阻塞API，占死了tokio运行时的工作线程，导致process_request返回后调度器无法切回generate的await点继续执行
• 持有非异步安全的锁（如std::sync::Mutex）跨await，触发死锁
• 依赖的tokio版本不统一，不同运行时的Future无法互相调度
• 输出缓冲未刷新，导致你误以为process_request执行完成，实际已经在后续逻辑panic/卡住

排查步骤 #

• 第一步：确认输出真实性
  在process_request的打印语句后强制刷出标准输出，排除缓冲干扰：

  println!("Function runs to this point and prints this message");
  std::io::stdout().flush().unwrap(); // 新增该行
  

  如果加了之后该日志不再打印，说明process_request实际在打印前就已经卡住/panic，排查打印前的省略代码逻辑即可。

• 第二步：排查阻塞API使用
  检查所有异步函数内的代码，禁止在异步上下文直接调用以下同步API，必须替换为tokio的异步实现：

  • 线程休眠：std::thread::sleep → 替换为 tokio::time::sleep(Duration::from_secs(N)).await
  • 文件IO：std::fs下的所有接口 → 替换为 tokio::fs下的对应异步接口
  • 网络IO：同步的TCP/UDP调用 → 替换为tokio的异步网络接口
  • 同步锁：如果持有锁的周期跨await，std::sync::Mutex/RwLock → 替换为 tokio::sync::Mutex/RwLock

• 第三步：检查tokio版本一致性
  执行cargo tree | grep tokio，确认所有依赖的tokio主版本号一致，如果出现多个版本，在Cargo.toml里强制指定统一的tokio版本即可解决跨运行时调度问题。

• 第四步：调整测试运行时配置
  给测试用例指定多线程运行时，验证是否是单线程运行时被占死导致的问题：

  #[tokio::test(flavor = "multi_thread", worker_threads = 2)]
  async fn test_gen() {
      // 原有测试逻辑
  }
  

  如果修改后测试不再卡住，说明确实存在同步阻塞操作占用单运行时线程的问题，回到第二步继续定位即可。

• 第五步：加超时获取栈信息
  给测试逻辑加超时，快速定位卡住位置：

  let result = tokio::time::timeout(
      std::time::Duration::from_secs(5),
      generate(request.unwrap())
  ).await.expect("测试超时5秒");
  

  超时后会抛出panic，可以通过栈回溯定位到具体卡住的代码行。

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