Django处理上传Excel文件报错：Invalid file path or buffer object type

核心错误原因 #

1. QuerySet类型不匹配：Worksheet.objects.filter(pk=pk)返回的是QuerySet集合对象（即使仅匹配一条数据），而pd.read_excel()要求传入文件路径、文件对象或二进制数据，直接传递QuerySet会触发类型错误。
2. 视图函数参数错误：函数视图定义了self参数（仅类视图需要），且缺少Django视图必需的request参数，会导致参数传递异常。
3. DataFrame调用错误：代码中试图访问df.url（DataFrame无此属性），且用df.getvalue()生成响应内容也是错误的，DataFrame没有该方法。

分步解决方法 #

1. 修正视图函数参数与对象获取 #

将filter()替换为get()以获取单个Worksheet对象，同时修正视图参数：

# 错误写法
def dataprocess(self, pk):
    data = Worksheet.objects.filter(pk=pk)

# 正确写法
def dataprocess(request, pk):
    data = Worksheet.objects.get(pk=pk)  # pk唯一，直接返回单个对象

2. 传入正确的文件路径给pandas #

假设Worksheet模型中用FileField（字段名为worksheet）存储上传文件，通过.path属性获取服务器本地文件路径：

# 根据文件后缀选择引擎（xlrd仅支持xls，openpyxl支持xlsx）
if data.worksheet.name.endswith('.xlsx'):
    df = pd.read_excel(data.worksheet.path, engine='openpyxl')
else:
    df = pd.read_excel(data.worksheet.path, engine='xlrd')

3. 修复Excel响应生成逻辑 #

使用BytesIO缓冲区存储DataFrame导出的Excel数据，配合pd.to_excel()生成正确的响应：

from io import BytesIO

# ... 数据处理逻辑 ...

# 生成Excel文件到缓冲区
output = BytesIO()
df.to_excel(output, index=False, engine='openpyxl')
output.seek(0)  # 重置缓冲区指针到开头

# 构造响应
response = HttpResponse(output, content_type='application/vnd.openxmlformats-officedocument.spreadsheetml.sheet')
response['Content-Disposition'] = 'attachment;filename="ezpassreport.xlsx"'
return response

完整修正后的视图代码 #

from io import BytesIO
import pandas as pd
from django.http import HttpResponse
from .models import Worksheet

def dataprocess(request, pk):
    # 获取单个工作表对象
    data = Worksheet.objects.get(pk=pk)
    
    # 读取Excel文件
    if data.worksheet.name.endswith('.xlsx'):
        df = pd.read_excel(data.worksheet.path, engine='openpyxl')
    else:
        df = pd.read_excel(data.worksheet.path, engine='xlrd')
    
    # 此处添加数据处理逻辑（如去重、清洗）
    # df = dataprocessor(df)
    
    # 生成可下载的Excel文件
    output = BytesIO()
    df.to_excel(output, index=False, engine='openpyxl')
    output.seek(0)
    
    response = HttpResponse(output, content_type='application/vnd.openxmlformats-officedocument.spreadsheetml.sheet')
    response['Content-Disposition'] = 'attachment;filename="ezpassreport.xlsx"'
    return response

额外注意事项 #

• 确保Worksheet模型的FileField配置正确：

  class Worksheet(models.Model):
      worksheet = models.FileField(upload_to='worksheets/')  # 指定文件存储目录
      # 其他字段...
  

• 安装依赖包：pip install pandas xlrd openpyxl
• 确认服务器对MEDIA_ROOT目录有读取权限。

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