使用WriteFile重叠IO时偶尔出现ERROR_INVALID_HANDLE错误的排查求助

从你提供的代码片段来看，有几个关键点可能导致这个偶发的错误，我逐一帮你梳理：

1. 数组初始化时的内存清零错误 #

在初始化OverlappedArray的代码里，这一行存在严重问题：

memset(oarray, 0, sizeof(oarray));

oarray是OVERLAPPED*类型的指针，sizeof(oarray)返回的是指针本身的大小（32位系统是4字节，64位是8字节），而不是整个OVERLAPPED数组的总大小。这意味着你只清零了第一个OVERLAPPED对象的前几个字节，后面的所有OVERLAPPED结构都保留着未初始化的垃圾值。

当后续使用这些未初始化的OVERLAPPED结构时，它们的hEvent字段可能是一个随机的无效句柄，这直接会导致WriteFile调用时返回ERROR_INVALID_HANDLE。

修复方法是计算整个数组的大小：

memset(oarray, 0, sizeof(OVERLAPPED) * cMaxOverlappedIOS);

2. 多线程环境下的同步缺失 #

从代码逻辑看，你应该是在多线程环境下使用重叠IO（否则不需要维护OverlappedInUse数组），但目前的GetOverlapped方法没有任何同步机制（比如临界区、互斥量）。

当多个线程同时调用GetOverlapped时，可能会出现竞态条件：两个线程同时检测到同一个index的OverlappedInUse为false，然后都标记为true并复用同一个OVERLAPPED结构。如果其中一个线程的WriteFile操作还没完成，另一个线程就修改了这个结构的Offset/OffsetHigh甚至hEvent，就会导致句柄或结构状态无效，触发错误。

你需要在访问OverlappedInUse和OverlappedArray的地方添加同步保护，比如给每个volume对应一个临界区：

// 初始化时给每个volume创建临界区
std::unordered_map<std::string, CRITICAL_SECTION> volCritSections;
for(auto vol : readVolumes) {
    InitializeCriticalSection(&volCritSections[vol]);
    // ... 其他初始化代码
}

// 在GetOverlapped里访问数组前加锁
EnterCriticalSection(&volCritSections[volumeName]);
// 查找可用index的逻辑
LeaveCriticalSection(&volCritSections[volumeName]);

3. OVERLAPPED结构的复用时机错误 #

在WaitForPendingIOs方法中，你需要确保只有当对应的重叠IO操作完全完成（通过GetOverlappedResult确认）后，才将OverlappedInUse标记为false并复用该结构。如果在IO操作还未完成时就复用，会导致原有的hEvent或结构被覆盖，后续操作时引用无效的句柄或状态。

另外，每次复用OVERLAPPED结构时，记得重置hEvent的状态（如果是手动重置事件），否则可能导致后续的等待逻辑出错，间接引发句柄相关问题。

4. 潜在的hFile句柄问题 #

虽然你怀疑是OVERLAPPED的问题，但也可以排查下hFile本身：确保在调用WriteFile时，hFile没有被其他线程意外关闭，或者该句柄没有被重复使用、释放。可以在出错时打印hFile的值，对比正常和异常情况的差异。

额外建议 #

在出错时，可以打印出当前使用的lpOverlapped的地址和hEvent的值，看看是否是某个特定的OVERLAPPED结构反复出问题，这有助于快速定位是初始化错误还是复用逻辑的问题。

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