基于Django的本地文件夹批量自动上传功能实现及部署问题咨询

功能可行性与自动化实现 #

• 完全可行，但不能直接通过后端读取用户本地文件路径——浏览器的安全机制禁止前端/后端直接访问用户本地文件系统（这是跨域/本地文件访问的安全限制，所有前端框架都绕不开）。
• 自动化上传可以实现，但必须让用户主动选择文件夹（而非手动输入路径），借助浏览器的webkitdirectory属性（主流浏览器均支持）获取用户选择的文件夹及内部文件，再通过前端JS批量上传到Django后端。

本地运行正常但Apache生产环境失效的原因 #

• 本地开发时，Django的开发服务器和浏览器在同一台机器，你用os模块读取的是**服务器（即本地）**的文件系统，而非用户本地的，所以测试时看起来正常；但部署到Apache后，服务器的文件系统和用户本地完全无关，自然失效。
• Apache运行Django时通常使用www-data用户（Linux环境），该用户权限受限，即使你想读取服务器本地文件，也可能因权限不足失败，但这和你的核心需求（读取用户本地文件）无关。

正确的技术实现方案 #

前端部分（Bootstrap + JS/jQuery） #

• 使用支持文件夹选择的文件输入框：

  <input type="file" id="folder-upload" webkitdirectory directory multiple>
  

• 用JS监听文件选择事件，批量获取文件夹内所有文件（含子文件夹）：

  $('#folder-upload').on('change', function(e) {
    const files = Array.from(e.target.files);
    uploadFiles(files);
  });
  
  function uploadFiles(files) {
    const formData = new FormData();
    files.forEach(file => {
      formData.append('files', file, file.webkitRelativePath); // 保留文件相对路径
    });
  
    $.ajax({
      url: '/api/upload-folder/', // Django后端接口地址
      type: 'POST',
      data: formData,
      processData: false,
      contentType: false,
      success: () => alert('文件夹上传完成'),
      error: err => console.error('上传失败', err)
    });
  }
  

Django后端部分 #

• 编写接收批量文件的视图：

  from django.http import JsonResponse
  from django.views.decorators.csrf import csrf_exempt
  import os
  
  @csrf_exempt
  def upload_folder(request):
    if request.method == 'POST':
      files = request.FILES.getlist('files')
      # 服务器存储根目录，需确保Apache用户有写入权限
      save_root = '/opt/server-upload-storage/'
      os.makedirs(save_root, exist_ok=True)
  
      for file in files:
        # 根据文件相对路径创建子目录
        full_save_path = os.path.join(save_root, file.name)
        os.makedirs(os.path.dirname(full_save_path), exist_ok=True)
        # 分块写入文件
        with open(full_save_path, 'wb+') as dest_file:
          for chunk in file.chunks():
            dest_file.write(chunk)
      return JsonResponse({'status': 'success'})
    return JsonResponse({'status': 'error'}, status=400)
  

• 在urls.py中添加路由：

  from django.urls import path
  from .views import upload_folder
  
  urlpatterns = [
    path('api/upload-folder/', upload_folder, name='upload-folder'),
  ]
  

Apache生产环境配置注意事项 #

• 确保Apache运行用户（如www-data）对服务器存储目录有写入权限：

  sudo chown -R www-data:www-data /opt/server-upload-storage/
  sudo chmod -R 755 /opt/server-upload-storage/
  

• 若使用mod_wsgi部署，需确认WSGI进程的用户权限与存储目录权限匹配，避免读写失败。
• 建议将存储路径配置到Django的MEDIA_ROOT下，遵循框架规范，便于后续管理。

关键注意点 #

• 永远不要尝试让后端直接读取用户本地文件路径，这违反浏览器安全规则，也无法实现跨操作系统的通用路径读取。
• 前端选择文件夹是唯一合法的获取用户本地文件的途径，主流浏览器（Chrome、Firefox、Edge）均支持webkitdirectory/directory属性。
• 大文件批量上传时，建议添加进度条、断点续传等优化，提升用户体验。

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