写入NAS设备UNC路径文件触发ERROR_INVALID_HANDLE问题求助

这个问题我之前帮同事排查过类似的场景，核心差异在于NAS设备的文件系统/SMB协议实现和Windows本地驱动器的行为逻辑不同，具体原因和解决方案如下：

为什么文件句柄会失效？ #

• NAS与本地文件系统的句柄语义不同：本地硬盘或U盘使用的NTFS/FAT32等文件系统，在空间不足导致写入截断时，只是暂时无法完成写入操作，但文件句柄本身依然保持有效状态——内核驱动不会因为一次写入失败就标记句柄无效。而大多数NAS设备基于类Unix文件系统（比如Ext4、Btrfs）或者定制的SMB服务端实现，当检测到空间不足并触发写入截断时，为了保证文件数据的一致性，SMB服务端会主动关闭对应的文件会话，导致客户端（你的Windows程序）持有的句柄直接变成无效状态，即使后续释放了空间，这个旧句柄也无法再被复用。
• SMB协议的交互逻辑差异：访问本地文件是直接与Windows内核驱动交互，而访问NAS是通过SMB协议进行网络通信。当NAS返回“空间不足”的错误时，部分SMB服务端会在底层终止当前的文件连接会话，这就导致客户端的句柄失去了对应的服务端资源，自然会触发ERROR_INVALID_HANDLE（错误6）。

是否需要重置句柄？ #

是的，必须重置句柄，这是目前解决这个问题最可靠的方式：

1. 当捕获到ERROR_DISK_FULL（空间不足）错误时，立即调用CloseHandle关闭当前的无效句柄；
2. 确认NAS空间释放后，通过CreateFile重新打开目标文件（注意指定合适的打开模式，比如如果是追加写入，要使用FILE_APPEND_DATA标志，避免覆盖已有内容）；
3. 重新打开后，再继续执行后续的写入操作。

额外的优化建议 #

• 提前检查可用空间：在写入前可以调用GetDiskFreeSpaceExW函数获取NAS共享路径的可用空间，提前预判是否有足够空间完成写入。不过要注意，这个检查和实际写入之间存在时间窗口，可能有其他进程占用空间，所以错误处理依然不能少；
• 检查NAS的SMB配置：部分NAS设备允许调整SMB服务的行为，比如是否在空间不足时保留文件会话。你可以登录NAS的管理界面，查看SMB协议相关的设置（比如“文件锁定”“会话超时”等选项），尝试调整后测试是否能改善这个问题。

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