PHP跨多系统文件操作时rename重命名文件偶发失败问题咨询

核心疑问解答 #

你怀疑的copy函数提前返回的情况，在本地文件系统操作时不会出现，PHP的copy只有在数据完全写入、文件句柄正常关闭后才会返回true。你遇到的随机失败本质是Linux挂载Windows SMB共享的缓存同步延迟问题，和PHP本身的函数逻辑无关。

问题根因 #

你的操作链路涉及3个跨网络的异构文件系统，Linux的SMB客户端、Windows的SMB服务端默认都开启了多层缓存：

• Linux侧SMB客户端默认启用写入缓存，copy操作返回成功时，数据可能还停留在Linux本地缓存，并未实际同步到Windows处理服务器的磁盘上
• Windows SMB服务端默认有1-2秒的目录元数据缓存，刚写入的文件不会立刻出现在目录列表中，此时调用rename就会抛出「No such file or directory」的错误
• 你提到的同Windows服务器内rename只需修改指针的逻辑，只在Windows本地文件系统操作时成立，通过SMB协议发起的rename操作需要等待服务端元数据同步完成，否则就会随机失败

修复方案 #

你可以按优先级选择以下方案修复：

1. 调整Linux SMB挂载参数
   挂载Windows共享时添加cache=none、directio参数，禁用客户端侧的写入缓存，保证copy返回时数据已经同步到Windows服务端，示例挂载参数：

   mount -t cifs //处理服务器IP/共享路径 /mnt/处理服务器挂载路径 -o username=你的账号,password=你的密码,cache=none,directio,file_mode=0777,dir_mode=0777
   

2. 增加文件校验和短延时
   第二个copy执行完成后，不要立刻执行rename，先校验临时文件大小和源文件大小是否一致，确认一致后再加100~500毫秒的延时，给SMB元数据同步留足时间，示例代码修改：

   if (!copy($fileServerPath.$filename,$processServerPathTmp.$filename)) {
       error_log("Filehandler: Could not copy $filename from file server to process server tmp");  
   } else {
       // 新增校验逻辑
       $sourceSize = filesize($fileServerPath.$filename);
       $tmpSize = filesize($processServerPathTmp.$filename);
       if ($sourceSize !== $tmpSize) {
           // 可在此处添加重试copy逻辑，或者记录错误
           error_log("Filehandler: Tmp file size mismatch for $filename");
       } else {
           // 增加100毫秒延时，可根据实际情况调整
           usleep(100000);
           if (!rename($processServerPathTmp.$filename,$processServerPath.$filename)) {
               error_log("Filehandler: Could not move $filename from process server tmp to process server");
           }
       }
   }
   

3. 关闭Windows SMB目录缓存
   在处理服务器的Windows系统中，打开注册表编辑器，定位到HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\LanmanServer\Parameters，新增DWORD类型的DirectoryCacheLifetime值，设置为0，重启LanmanServer服务生效，彻底关闭服务端的目录元数据缓存。

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