Flask接收前端Ajax文件上传与表单数据完整指南
发布时间：2026-10-16| 14人浏览过
本文详细解析如何在Flask中通过Ajax接收前端传来的表单数据及文件。重点介绍了HTML5 FormData对象的使用、jQuery AJAX配置中processData与contentType设为false的关键性，以及后端request.form和request.files的正确获取方式。同时对比了纯文本表单的serialize序列化方法，确保数据完整传递。
在Web开发中，Flask接收前端通过Ajax提交的表单数据是一个常见需求，特别是当表单中包含文件上传时，处理逻辑与普通文本提交有所不同。
前端HTML页面通常包含一个用于输入文本信息的text类型输入框，以及一个用于选择并上传文件的file类型输入控件。
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta http-equiv="X-UA-Compatible" content="ie=edge">
<title>拍照</title>
</head>
<body>
<h1>拍照上传演示</h1>
<form id="upForm" enctype="multipart/form-data" method="POST">
<p>
<span>用户名:</span>
<input type="text" name="username" />
</p>
<input name="pic" type="file" accept="image/*" capture="camera" />
<a onclick="upload()">上传</a>
</form>
<img id="image" width="300" height="200" />
</body>
<script src="https://cdn.bootcss.com/jquery/3.4.1/jquery.min.js"></script>
<script>
function upload() {
var data = new FormData($("#upForm")[0]); //注意jQuery选择出来的结果是个数组,需要加上[0]获取
$.ajax({
url: '/do',
method: 'POST',
data: data,
processData: false,
contentType: false,
cache: false,
success: function (ret) {
console.log(ret)
}
})
//return false //表单直接调用的话应该返回false防止二次提交,<form οnsubmit="return upload()">
}
</script>
</html>
后端使用Python编写，基于Flask框架处理HTTP请求。
import os
from flask import Flask, render_template, request, jsonify
from werkzeug import secure_filename
TEMPLATES_AUTO_RELOAD = True
app = Flask(__name__)
app.config.from_object(__name__)
# 设置Flask jsonify返回中文不转码
app.config['JSON_AS_ASCII'] = False
PIC_FOLDER = os.path.join(app.root_path, 'upload_pic')
@app.route('/', methods=['GET'])
def hello():
return render_template('index.html')
@app.route('/do', methods=['POST'])
def do():
data = request.form
file = request.files['pic']
result = {'username': data['username']}
if file:
filename = secure_filename(file.filename)
file.save(os.path.join(PIC_FOLDER, filename))
result['pic'] = filename
return jsonify(result)
if __name__ == '__main__':
app.run(debug=False, host='0.0.0.0', port=8000)
Flask框架通过特定的路由和请求对象方法，配合前端的Ajax异步请求，实现数据的接收与响应。
前端HTML代码示例展示了表单结构，包括用户名输入框、文件选择器以及触发上传的按钮。
<form id="demo_form">
输入框： <input type="text" name="nick_name" />
<input type="submit" value="ajax请求"/>
</form>JavaScript代码利用jQuery库发起Ajax POST请求，关键在于正确构造FormData对象并配置Ajax参数。
//首先需要禁止form表单的action自动提交
$("#demo_form").submit(function(e){
e.preventDefault();
$.ajax({
url:"/demo",
type:'POST',
data: $(this).serialize(), // 这个序列化传递很重要
headers:{
"X-CSRF-Token": getCookie('csrf_token')
},
success:function (resp) {
// window.location.href = "/admin/page";
if(resp.error){
console.log(resp.errmsg);
}
}
})
});Python Flask后端代码定义了路由，从request对象中提取表单字段和文件流，进行安全文件名处理并保存文件，最后返回JSON响应。
@app.route("/demo", methods=["POST"])
def demo():
nick_name = request.form.get("nick_name")
print(nick_name)
return "ok"对于纯文本表单，使用jQuery的serialize()方法进行序列化至关重要，若忽略此步骤或未正确配置Ajax参数，后端获取的数据可能为None。
总结上述实现要点与注意事项。
以上为个人经验总结，希望能给大家一个参考，也希望大家多多支持本站。
免责声明：本文内容仅供参考，不代表本站观点。转载或引用请注明出处。
