Flask网站文件上传正常但无法下载的问题修复求助

核心问题排查方向及修复方案 #

• 路径匹配错误
  核对下载路由中文件路径的拼接逻辑，确保代码中读取的路径和文件实际存储路径完全一致。比如上传配置为app.config['UPLOAD_FOLDER'] = 'uploads'，下载时必须用os.path.join(app.config['UPLOAD_FOLDER'], filename)生成正确路径，避免硬编码路径导致的不一致。
• 文件权限不足
  服务器上传目录或目标文件可能没有读取权限，执行chmod -R 755 /path/to/your/uploads赋予目录可读权限，确保Flask进程能正常读取文件。
• send_from_directory参数错误
  该方法要求第一个参数为绝对路径，用相对路径会导致文件查找失败。可通过os.path.abspath(app.config['UPLOAD_FOLDER'])获取绝对路径后传入。
• 特殊文件名编码问题
  若文件名包含中文或特殊字符，需对文件名编码后再返回，避免解析错误：

  from urllib.parse import quote
  
  @app.route('/download/<filename>')
  def download_file(filename):
      uploads = os.path.abspath(app.config['UPLOAD_FOLDER'])
      encoded_filename = quote(filename.encode('utf-8'))
      return send_from_directory(
          uploads,
          filename,
          as_attachment=True,
          download_name=encoded_filename
      )
  

• 未处理文件不存在场景
  请求下载不存在的文件会触发500错误，需提前判断并返回404：

  @app.route('/download/<filename>')
  def download_file(filename):
      uploads = os.path.abspath(app.config['UPLOAD_FOLDER'])
      file_path = os.path.join(uploads, filename)
      if not os.path.exists(file_path):
          return "文件不存在", 404
      return send_from_directory(uploads, filename, as_attachment=True)
  

• 开启调试模式定位细节
  启动Flask时添加app.run(debug=True)，此时页面会显示具体错误堆栈，快速定位路径、权限等具体问题。

额外检查项 #

1. 确认UPLOAD_FOLDER对应的目录已创建，避免上传时自动创建目录但权限异常。
2. 检查反向代理（Nginx/Apache）配置，是否限制了静态文件访问或转发规则错误。

内容的提问来源于stack exchange，提问作者The Russian Cartoons