Laravel+AJAX多图上传：共享目录双端重命名问题求助

问题背景 #

开发Laravel项目时需实现多图上传功能，核心需求：

• 源文件夹与目标文件夹均为网络共享路径，文件以新名称上传至目标文件夹后，需同步重命名源文件夹内的对应文件；
• 若文件来自随机文件夹，则无需处理源目录文件。

当前遇到的问题：执行源目录文件重命名时，报错**"The process cannot access the file because it is being used by another process (code: 32)"**，尝试删除源文件也会触发相同错误。

问题根源 #

错误由文件句柄未释放导致：Laravel的UploadedFile对象在完成上传操作后，可能仍持有临时文件的引用；同时网络共享目录的文件锁定机制，也会阻止未释放资源的文件被修改。直接使用原生rename函数无法正确处理网络共享目录的权限与锁定逻辑。

解决方案 #

1. 配置网络共享磁盘 #

首先在config/filesystems.php中配置网络共享目录对应的磁盘，统一用Laravel Filesystem处理文件操作：

'disks' => [
    // ...其他磁盘配置
    'network_source' => [
        'driver' => 'local',
        'root' => '\\\\172.20.1.201\\source\\',
        'visibility' => 'public',
        'permissions' => [
            'file' => ['public' => 0664, 'private' => 0600],
            'dir' => ['public' => 0775, 'private' => 0700],
        ],
    ],
    'network_destination' => [
        'driver' => 'local',
        'root' => '\\\\172.20.1.201\\destination\\',
        'visibility' => 'public',
        'permissions' => [
            'file' => ['public' => 0664, 'private' => 0600],
            'dir' => ['public' => 0775, 'private' => 0700],
        ],
    ],
],

2. 修改控制器逻辑 #

更新uploadImages方法，添加资源释放、条件判断（仅处理源目录文件），并使用Laravel Filesystem替代原生函数：

namespace App\Http\Controllers;

use Illuminate\Http\Request;
use Illuminate\Support\Facades\Storage;
use Illuminate\Support\Facades\Log;

class ImageController extends Controller
{
    public function uploadImages(Request $request)
    {
        $images = $request->file('images');
        $newFilenames = $request->input('newFilenames');
        
        $sourceDisk = Storage::disk('network_source');
        $destinationDisk = Storage::disk('network_destination');

        foreach ($images as $index => $image) {
            $originalName = $image->getClientOriginalName();
            $extension = $image->getClientOriginalExtension();
            $newName = $newFilenames[$index] . '.' . $extension;

            // 上传文件到目标目录
            $destinationDisk->putFileAs('', $image, $newName);

            // 手动释放上传文件的句柄，解决资源占用问题
            fclose($image->getRealPath());

            // 仅当源目录存在该文件时执行重命名
            if ($sourceDisk->exists($originalName)) {
                try {
                    // 使用Laravel Filesystem的move方法完成重命名
                    $sourceDisk->move($originalName, $newName);
                } catch (\Exception $e) {
                    // 记录错误日志，避免单个文件失败中断整个流程
                    Log::error('源文件重命名失败: ' . $e->getMessage());
                }
            }
        }

        return response()->json(['message' => '图片上传并重命名成功']);
    }
}

3. 权限与环境检查 #

• 确保Web服务器运行用户（Windows下为IUSR/IIS应用池用户，Linux下为www-data）拥有网络共享目录的读取、写入、修改权限；
• 检查网络共享目录是否开启了文件锁定功能，必要时调整共享设置。

4. 额外优化 #

若需严格区分文件是否来自指定共享源，可在前端添加来源标识，或后端通过文件属性验证（仅适用于部分网络共享环境），避免对随机文件夹的文件执行无效操作。

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