Django中用Pandas导入文件时出现MultiValueDictKeyError('countryList')问题

错误原因 #

MultiValueDictKeyError at /countyImportFromExcelPd/ 'countryList' 本质是请求的FILES字典里找不到countryList这个键，大概率是表单配置、视图逻辑或拼写问题导致的，以下是针对性修复方案：

逐一排查修复 #

1. 核对前端表单配置 #

确保上传表单满足两个核心要求：

• 文件输入框的name属性必须严格等于countryList
• 表单必须添加enctype="multipart/form-data"（上传文件必填）

示例表单代码：

<form method="POST" enctype="multipart/form-data" action="{% url 'county-import-ExcelPd' %}">
    {% csrf_token %}
    <input type="file" name="countryList" />
    <button type="submit">上传导入</button>
</form>

2. 优化视图的键存在性判断 #

直接用request.FILES['countryList']取值会在键不存在时抛出异常，改用.get()方法做安全判断：

def countyImportFromExcelPd(request): 
    if request.method == 'POST':      
        countryList = request.FILES.get('countryList')
        if countryList:  # 确认文件已上传
            fs = FileSystemStorage()
            filename = fs.save(countryList.name, countryList)
            uploaded_file_url = fs.url(filename)
            # 用绝对路径读取文件，避免Pandas找不到文件
            empexceldata = pd.read_excel(fs.path(filename))  
            for row in empexceldata.itertuples():
                # 用getattr避免Excel列名不匹配导致的AttributeError
                Country.objects.create(
                    country_iso2=getattr(row, 'country_iso2', None),
                    country_iso3=getattr(row, 'country_iso3', None),
                    country_name_EN=getattr(row, 'country_name_EN', None),
                    country_name_FR=getattr(row, 'country_name_FR', None),
                    country_name_DE=getattr(row, 'country_name_DE', None),
                    country_name_ES=getattr(row, 'country_name_ES', None),
                    country_comment=getattr(row, 'country_comment', '')
                )
            # create方法会自动保存，无需再调用obj.save()
            return render(request, 'students_management_app/country-import.html', {
                'uploaded_file_url': uploaded_file_url
            })
    return render(request, 'country-import.html',{})

3. 修正拼写错误 #

注意到你的视图函数名、URL路径里的county是“县”的意思，而功能是导入国家（Country），属于拼写错误，建议统一修正避免混淆：
修改urls.py：

path('countryImportFromExcelPd/', views.countryImportFromExcelPd, name='country-import-ExcelPd'),

同时同步修改视图函数名为countryImportFromExcelPd。

4. 验证文件读取路径 #

FileSystemStorage默认存储路径可能不在当前工作目录，用fs.path(filename)获取文件绝对路径，确保Pandas能正确读取Excel文件。

额外提示 #

• 导入前先检查Excel的列名是否和Model字段完全匹配，避免后续出现AttributeError
• 可以添加try-except块捕获文件格式错误、字段缺失等异常，提升用户体验

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