Django自动批量上传书籍至数据库失败问题排查

以下是几种常见的问题原因及对应的排查、解决方法：

1. 表单验证失败 #

Django的ModelForm/Form在接收POST数据时，若数据不符合字段规则（必填项缺失、数据类型不匹配、格式错误等），会直接返回带空表单的页面（状态码仍为200），且不会执行数据保存操作。

• 排查：在视图中打印form.errors查看具体验证错误，或在脚本中打印响应内容，确认是否包含表单错误提示。
• 解决：确保脚本构造的所有数据与表单字段要求一致，比如数字类型字段传数值而非字符串、日期字段用YYYY-MM-DD格式、必填字段不遗漏。

2. 请求方式错误 #

如果脚本使用GET请求访问上传接口，而视图仅在POST请求时处理数据，GET请求会直接返回空表单页面，状态码200。

• 排查：检查脚本中的请求方法，确认是POST而非GET。
• 解决：修改脚本，使用POST请求发送数据。

3. CSRF令牌缺失或无效 #

Django默认启用CSRF保护，若脚本发送POST请求时未携带正确的CSRF令牌，视图会拒绝处理数据，通常会返回空表单页面。

• 排查：临时在视图上添加@csrf_exempt装饰器测试，若数据能正常写入，说明是CSRF问题。
• 解决：脚本先访问表单页面获取CSRF令牌（从cookie或页面中提取），再在POST请求中携带该令牌（可放在表单数据csrfmiddlewaretoken中，或请求头X-CSRFToken中）。

4. 视图逻辑存在疏漏 #

视图可能存在以下问题导致数据未保存：

• 未正确判断请求方法，比如不管是GET还是POST都直接返回空表单；
• 表单验证通过后未调用form.save()；
• 使用form.save(commit=False)但未执行后续的保存操作（比如未调用instance.save()）。
• 排查：检查视图代码，确认request.method == 'POST'分支逻辑正确，验证通过后执行了保存操作。
• 解决：修正视图逻辑，确保POST请求验证通过后完成数据保存。

示例代码参考 #

正确的上传脚本（使用requests库）

import requests

# 建立会话，保持cookie
session = requests.Session()

# 先访问上传页面获取CSRF令牌
form_page = session.get("http://your-domain.com/book/upload/")
csrf_token = session.cookies.get("csrftoken")

# 构造符合要求的书籍数据
book_data = {
    "title": "批量测试书籍",
    "author": "测试作者",
    "price": 39.9,
    "publication_date": "2024-05-20",
    "csrfmiddlewaretoken": csrf_token
}

# 发送POST请求
response = session.post("http://your-domain.com/book/upload/", data=book_data)
print("响应状态码:", response.status_code)
print("响应内容:", response.text)

正确的视图示例

from django.shortcuts import render
from django.views.decorators.csrf import csrf_exempt  # 仅测试用，正式环境移除
from .forms import BookForm

def book_upload(request):
    if request.method == "POST":
        form = BookForm(request.POST)
        if form.is_valid():
            form.save()
            # 保存成功后可重定向或返回成功页面
            return render(request, "upload_success.html")
        else:
            # 打印验证错误，便于排查
            print("表单验证错误:", form.errors)
    else:
        form = BookForm()
    return render(request, "book_upload.html", {"form": form})

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