VirtualBox重定向U盘WriteFile报错1006等问题求助

问题核心 #

你遇到的是虚拟化Windows 11环境下U盘介质状态异常导致的写入失败：首次启动程序可正常解压，后续所有尝试均失败，伴随WriteFile错误1006（无效文件句柄）和STATUS_VERIFY_REQUIRED（0x80000016，介质变更验证中）。已排除句柄未关闭、缓冲区大小、API选择等常规问题，问题根源在于虚拟化平台与U盘的交互机制。

解决方案 #

1. 切换U盘的性能策略 #

虚拟化环境中，默认的「快速移除」策略容易触发系统对介质状态的误判：

• 右键U盘盘符 → 属性 → 硬件 → 选中目标U盘 → 属性 → 策略
• 切换为「更好的性能」，勾选「启用设备上的写入缓存」
• 重启虚拟机后重新测试

2. 强制刷新文件系统缓存 #

每次写入完成后主动刷新U盘缓存，避免系统残留的状态异常：
在CloseHandle(fd)之前添加以下代码：

DWORD bytesReturned;
DeviceIoControl(fd, FSCTL_FLUSH_BUFFERS, NULL, 0, NULL, 0, &bytesReturned, NULL);

3. 修改CreateFile的参数配置 #

原代码的共享模式和文件标志在虚拟化环境下易引发资源锁死：

• 共享模式从0改为FILE_SHARE_READ | FILE_SHARE_WRITE，允许系统进程访问U盘文件
• 添加FILE_FLAG_WRITE_THROUGH标志，绕过系统缓存直接写入介质，避免缓存不一致
  修改后的CreateFile调用：

HANDLE fd = CreateFile(
    file.c_str(),
    GENERIC_WRITE,
    FILE_SHARE_READ | FILE_SHARE_WRITE,
    NULL,
    CREATE_ALWAYS,
    FILE_ATTRIBUTE_NORMAL | FILE_FLAG_WRITE_THROUGH,
    NULL
);

4. 调整虚拟机的U盘连接设置 #

虚拟化平台的U盘直通模式可能存在状态残留：

• 解压失败后，先在虚拟机中安全弹出U盘，再在宿主机断开并重新连接，重新映射到虚拟机
• 尝试将U盘从「USB 3.x」切换为「USB 2.0」模式，部分平台对USB 3.x的状态检测存在兼容性问题

5. 增加错误重试逻辑 #

针对虚拟化环境的不稳定特性，对特定错误添加重试机制：

BOOL writeSuccess;
DWORD lastError;
do {
    writeSuccess = WriteFile(fd, buffer, readLen, NULL, NULL);
    lastError = GetLastError();
    // 遇到介质验证错误时等待并重试
    if (!writeSuccess && lastError == 0x80000016) {
        Sleep(100);
    }
} while (!writeSuccess && lastError == 0x80000016);

// 处理其他不可重试错误
if (!writeSuccess && lastError != ERROR_SUCCESS) {
    fprintf(stderr, "写入失败，错误码：%lu\n", lastError);
    CloseHandle(fd);
    zip_fclose(zf);
    zip_close(za);
    return -1;
}

额外提示 #

• 确保使用针对Windows平台编译的最新版libzip，旧版本可能存在文件系统兼容性问题
• 解压过程中不要在宿主机或虚拟机中操作U盘，避免介质状态冲突

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