子线程中WaitForSingleObject始终返回WAIT_TIMEOUT问题求助

问题背景 #

基于pthreads开发的Windows多线程命令行解释器，读取线程通过WaitForSingleObject等待标准输入句柄，但在Git Bash直接键盘输入时始终返回WAIT_TIMEOUT，以下环境则运行正常：

• Git Bash中标准输入重定向自文件
• GDB中无输入重定向运行
• CMD/PowerShell中无输入重定向运行

根本原因 #

Git Bash在非重定向输入场景下，给程序提供的stdin是伪终端(PTY)句柄，而非Windows原生控制台输入句柄。WaitForSingleObject仅支持等待同步对象（如互斥体、事件、进程/线程句柄），并不支持对PTY或管道类句柄的等待——这类句柄不具备同步信号状态，因此调用会直接超时返回。

而在重定向输入时，stdin为文件句柄，Windows允许对文件句柄等待（有数据可读时触发信号）；CMD/PowerShell中是原生控制台句柄，WaitForSingleObject可正常等待输入就绪。

解决方案 #

方案1：异步I/O+事件等待 #

通过ReadFile异步模式配合事件对象，实现跨环境的输入等待逻辑：

HANDLE stdin_handle = GetStdHandle(STD_INPUT_HANDLE);
HANDLE read_event = CreateEvent(NULL, TRUE, FALSE, NULL);
OVERLAPPED overlapped = {0};
overlapped.hEvent = read_event;

char buffer[1024];
DWORD bytes_read;

do {
    // 发起异步读请求
    if (!ReadFile(stdin_handle, buffer, sizeof(buffer)-1, &bytes_read, &overlapped)) {
        if (GetLastError() != ERROR_IO_PENDING) {
            // 处理错误，退出循环
            break;
        }
        // 等待读操作完成或超时
        DWORD wait_result = WaitForSingleObject(read_event, 100);
        if (wait_result == WAIT_OBJECT_0) {
            // 获取读操作结果
            GetOverlappedResult(stdin_handle, &overlapped, &bytes_read, FALSE);
            buffer[bytes_read] = '\0';
            // 处理读取到的输入内容
            // ...
            // 重置事件，准备下一次读取
            ResetEvent(read_event);
        } else if (wait_result != WAIT_TIMEOUT) {
            // 处理等待错误，退出循环
            break;
        }
    } else {
        // 同步读取完成，直接处理
        buffer[bytes_read] = '\0';
        // 处理读取到的输入内容
        // ...
        ResetEvent(read_event);
    }

    /* 此处添加循环退出条件判断 */
} while(/* 循环条件 */);

CloseHandle(read_event);

方案2：区分控制台与非控制台环境 #

先判断当前stdin是否为原生控制台句柄，针对性选择等待逻辑：

HANDLE stdin_handle = GetStdHandle(STD_INPUT_HANDLE);
DWORD mode;
// 退出事件，用于线程终止控制
HANDLE exit_event = /* 你的退出事件句柄 */;

if (GetConsoleMode(stdin_handle, &mode)) {
    // 是控制台句柄，使用WaitForMultipleObjects等待输入或退出
    HANDLE events[2] = {stdin_handle, exit_event};
    DWORD wait_result;
    do {
        wait_result = WaitForMultipleObjects(2, events, FALSE, 100);
        if (wait_result == WAIT_OBJECT_0) {
            // 读取控制台输入记录
            INPUT_RECORD rec;
            DWORD num_read;
            ReadConsoleInput(stdin_handle, &rec, 1, &num_read);
            if (rec.EventType == KEY_EVENT && rec.Event.KeyEvent.bKeyDown) {
                // 处理按键输入
                // ...
            }
        } else if (wait_result == WAIT_OBJECT_0 + 1) {
            // 触发退出条件，终止循环
            break;
        }
    } while(wait_result == WAIT_TIMEOUT);
} else {
    // 非控制台句柄（如Git Bash的PTY），使用异步读逻辑
    // 参考方案1的异步读实现
}

方案3：简化循环读取 #

放弃等待逻辑，直接设置读取超时循环尝试读取，实现简单：

HANDLE stdin_handle = GetStdHandle(STD_INPUT_HANDLE);
char buffer[1024];
DWORD bytes_read;
COMMTIMEOUTS timeouts = {0};
timeouts.ReadTotalTimeoutConstant = 100; // 设置100ms读取超时
SetCommTimeouts(stdin_handle, &timeouts);

do {
    if (ReadFile(stdin_handle, buffer, sizeof(buffer)-1, &bytes_read, NULL)) {
        if (bytes_read > 0) {
            buffer[bytes_read] = '\0';
            // 处理读取到的输入内容
            // ...
        }
    } else {
        DWORD err = GetLastError();
        if (err != ERROR_TIMEOUT) {
            // 处理非超时错误，退出循环
            break;
        }
    }

    /* 此处添加循环退出条件判断 */
} while(/* 循环条件 */);

验证说明 #

• 方案1、3可兼容Git Bash的PTY环境与Windows原生控制台环境；
• 方案2对控制台环境做了优化，非控制台场景需 fallback 到异步读逻辑。

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