Flask应用访问上传文件报错UnboundLocalError问题排查求助

咱们先拆解你遇到的UnboundLocalError: local variable 'filename1' referenced before assignment错误——这个问题本质上要么是变量作用域没处理对，要么是文件上传逻辑里filename1根本没被正确赋值，结合你提供的代码片段，我给你一步步分析和解决：

一、先排查变量作用域问题 #

你提到用两个表单上传文件，然后在后续函数里对比差异。如果filename1是在处理第一个上传表单的视图函数里定义的局部变量，那后续的对比函数（不管是另一个视图还是单独的函数）肯定访问不到它。这里给你两个实用的解决思路：

• 用会话（session）存储文件名：在文件上传成功后，把文件名存入session，这样后续请求里可以轻松获取：

  from flask import session
  
  # 处理第一个文件上传的视图
  @app.route('/upload1', methods=['POST'])
  def upload_file1():
      file = request.files['file1']
      if file and allowed_file(file.filename):
          filename1 = secure_filename(file.filename)
          file.save(os.path.join(app.config['UPLOAD_FOLDER'], filename1))
          # 存入session
          session['filename1'] = filename1
          return '第一个文件上传成功'
  
  # 处理文件对比的视图
  @app.route('/compare')
  def compare_files():
      # 从session获取两个文件名
      filename1 = session.get('filename1')
      filename2 = session.get('filename2')
      if not filename1 or not filename2:
          return '请先上传两个文件哦'
      # 拼接完整路径开始对比逻辑
      file1_path = os.path.join(app.config['UPLOAD_FOLDER'], filename1)
      file2_path = os.path.join(app.config['UPLOAD_FOLDER'], filename2)
      # ... 你的文件差异对比代码
  

• 把文件名作为参数传递：如果对比逻辑是在上传第二个文件的请求里直接触发的，可以把第一个文件名作为参数传给对比函数，不用跨请求存储。

二、修复文件上传配置的潜在坑 #

你提供的配置里有几个容易踩的小问题，可能导致文件根本没保存，进而filename1没被赋值：

1. 上传路径的权限问题：UPLOAD_FOLDER = '/uploads'是系统根目录下的文件夹，普通用户权限大概率没法创建或写入，建议改成相对应用根目录的路径：

   UPLOAD_FOLDER = os.path.join(app.root_path, 'uploads')
   

   这样会在你的Flask应用根目录下创建uploads文件夹，权限问题会少很多。
2. 创建文件夹的代码错误：你写的os.mkdi...应该是os.makedirs，而且要加exist_ok=True参数，避免重复创建文件夹时报错：

   if not os.path.isdir(UPLOAD_FOLDER):
       os.makedirs(UPLOAD_FOLDER, exist_ok=True)
   

3. 别忘了导入必要模块：确保你已经导入了这些工具模块：

   import os
   from flask import Flask, request, session
   from werkzeug.utils import secure_filename
   

三、表单处理的关键细节 #

要确保你的前端表单配置正确，否则文件根本传不到后端：

• 表单必须设置enctype="multipart/form-data"，不然文件数据会丢失：

  <form method="POST" action="/upload1" enctype="multipart/form-data">
      <input type="file" name="file1">
      <button type="submit">上传第一个文件</button>
  </form>
  

• 在后端要严格校验文件合法性，避免无效上传导致filename1未赋值：

  def allowed_file(filename):
      return '.' in filename and \
             filename.rsplit('.', 1)[1].lower() in ALLOWED_EXTENSIONS
  

四、快速调试小技巧 #

如果还是找不到问题，可以在上传视图里加打印日志，确认filename1是否被正确赋值：

@app.route('/upload1', methods=['POST'])
def upload_file1():
    file = request.files.get('file1')
    print("收到的文件对象：", file)
    if file and allowed_file(file.filename):
        filename1 = secure_filename(file.filename)
        print("即将保存的文件名：", filename1)
        # ... 保存文件的逻辑
    else:
        print("文件不合法或未上传")

按这个步骤排查，应该能快速解决你的问题啦～

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