打开Windows资源管理器文件夹时写入文件触发stream != nullPtr断言失败求助

我之前维护旧C++项目时碰到过一模一样的问题！当时排查了好久才发现是Windows资源管理器的文件占用逻辑和代码里的文件打开模式冲突导致的。

问题原因 #

Windows资源管理器打开文件夹时，会自动生成文件缩略图、读取元数据（比如文档预览、媒体文件信息），这个过程中它会以独占共享模式锁定目标文件。而你的代码如果使用默认的文件打开方式（比如std::ofstream或fopen的默认参数），会因为无法获取文件的访问权限导致打开失败，进而触发stream != nullptr的断言——毕竟文件流创建失败后就是空指针。

可行的解决办法 #

1. 修改文件打开的共享权限（推荐） #

这是从代码层面彻底解决问题的方案，让你的程序和资源管理器兼容：

• 如果用C标准库的fopen，Windows平台下改用_fsopen显式指定共享模式：

  FILE* fp = _fsopen("your_target_file.txt", "wb", _SH_DENYNO); // 允许其他进程读写删除
  if (fp == nullptr) {
      // 处理文件打开失败的逻辑
  }
  

• 如果用C++的std::ofstream，可以结合Windows API的CreateFile先获取兼容的文件句柄，再关联到流：

  #include <fstream>
  #include <windows.h>
  #include <fcntl.h>
  #include <io.h>
  
  int main() {
      HANDLE hFile = CreateFile(L"your_target_file.txt", GENERIC_WRITE, 
                                FILE_SHARE_READ | FILE_SHARE_WRITE | FILE_SHARE_DELETE,
                                NULL, CREATE_ALWAYS, FILE_ATTRIBUTE_NORMAL, NULL);
      if (hFile != INVALID_HANDLE_VALUE) {
          std::ofstream ofs;
          ofs.attach(_open_osfhandle((intptr_t)hFile, _O_WRONLY | _O_BINARY));
          // 执行写入操作
          ofs << "test data";
          ofs.close(); // 关闭流时会自动释放文件句柄
      }
      return 0;
  }
  

2. 关闭资源管理器的预览/缩略图功能 #

这是系统级的临时解决方案，适合调试阶段快速验证：

• 打开目标文件夹，点击顶部「查看」选项卡，关闭「预览窗格」和「详细信息窗格」
• 打开「文件夹选项」→「查看」标签页，勾选「始终显示图标，从不显示缩略图」
  这样资源管理器就不会主动锁定文件生成预览了。

3. 添加文件打开重试逻辑 #

如果不想改代码也不想调整系统设置，可以在文件打开失败时加入重试机制：

FILE* fp = nullptr;
const int MAX_RETRY = 3;
int retry = 0;
while (retry < MAX_RETRY && fp == nullptr) {
    fp = fopen("your_target_file.txt", "wb");
    if (fp == nullptr) {
        Sleep(200); // 等待200毫秒后重试
        retry++;
    }
}
if (fp == nullptr) {
    // 处理最终打开失败的情况
}

资源管理器的文件锁定通常是短暂的，重试几次大概率能成功。

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