macOS下用ptrace写迷你调试器时Ptrace/waitpid偶发卡顿

我之前在macOS Sierra 10.12.6上折腾ptrace写单步调试器时，也碰到过这种偶发的冻结情况——跑循环测试几十秒就卡住。结合你的环境（clang-802.0.42），大概率是这几个细节没处理到位：

1. 子进程信号处理的竞态与参数错误 #

macOS的ptrace和Linux的行为差异很大，尤其是单步执行和信号传递的逻辑：

• 单步执行要用PT_STEP而非Linux的PTRACE_SINGLESTEP，而且参数必须传对：ptrace(PT_STEP, pid, (caddr_t)1, sig)，这里第三个参数固定为(caddr_t)1（macOS要求的占位值），第四个参数是子进程停止时收到的信号（WSTOPSIG(status)），如果不传这个信号，很容易导致信号丢失，子进程卡住。
• 错误示例：很多人会照搬Linux的写法，用ptrace(PT_STEP, pid, 0, 0)，这在macOS上会导致子进程无法正确处理后续信号，进而冻结。

2. waitpid的错误处理缺失 #

当父进程被外部信号（比如系统的其他信号）中断时，waitpid会返回-1并设置errno=EINTR，如果你的代码没处理这种情况，直接进入下一轮循环，就可能陷入无限等待：

• 修复方式：每次调用waitpid后检查返回值，若返回-1，先判断errno是否为EINTR，若是则重新调用waitpid；其他错误则直接退出并打印错误信息，避免死循环。
• 示例代码片段：

  pid_t wpid;
  int status;
  while (true) {
      wpid = waitpid(child, &status, 0);
      if (wpid == -1) {
          if (errno == EINTR) continue; // 被信号中断，重新等待
          perror("waitpid failed");
          break;
      }
      // 处理子进程状态
      if (WIFEXITED(status) || WIFSIGNALED(status)) {
          // 子进程已退出或被杀死，结束循环
          break;
      }
      if (WIFSTOPPED(status)) {
          int sig = WSTOPSIG(status);
          // 单步执行
          if (ptrace(PT_STEP, child, (caddr_t)1, sig) == -1) {
              perror("ptrace step failed");
              break;
          }
      }
  }
  

3. 子进程退出后的循环未终止 #

当子进程正常退出（WIFEXITED(status)）或被致命信号杀死（WIFSIGNALED(status)）时，父进程如果还继续调用ptrace和waitpid，就会因为子进程已不存在而陷入错误循环，导致程序冻结。

• 修复：在循环里先判断子进程是否已退出，若是则直接跳出循环，终止父进程逻辑。

4. 额外排查建议 #

• 给代码加详细的错误日志：每次ptrace和waitpid调用后，打印返回值、errno和当前子进程状态，这样冻结时就能定位到是哪一步出了问题。
• 检查SIP状态：macOS Sierra的System Integrity Protection（SIP）可能会限制ptrace的某些行为，你可以临时关闭SIP（重启按住Cmd+R进入恢复模式，终端执行csrutil disable）测试是否是这个原因，但测试后记得重新开启。

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