Flask怎么实现文件上传功能

千辰姑娘_3102

千辰姑娘_3102

2026-09-18

707人浏览

原创

必须确保HTML表单设enctype="multipart/form-data",否则request.files为空;后端用request.files.get('file')获取文件('file'为input的name值),保存前须用secure_filename()处理文件名、确保UPLOAD_FOLDER存在且用os.path.join构造路径。

flask怎么实现文件上传功能

Flask 中 request.files 怎么取到上传的文件

必须确保 HTML 表单设置了 enctype="multipart/form-data",否则 request.files 永远为空字典。Flask 不会报错,但你拿不到任何文件——这是最常被忽略的前提。

后端用法很简单:file = request.files.get('file'),其中 'file' 是表单里 的 name 属性值。如果前端用了多个文件输入或动态 name,得对应改 key。

  • 如果没选文件,file.filename 是空字符串(不是 None),别直接用它拼路径
  • file.filename 可被客户端任意篡改,不能直接用于保存路径,尤其不能拼进 os.path.join() 后直接写磁盘
  • 调用 file.save() 前,务必先检查 file.filename 是否非空且合法

怎么安全地保存上传的文件(避免路径遍历和覆盖)

别信 file.filename,它可能包含 ../../etc/passwd 这类恶意路径。正确做法是提取原始文件名、清理扩展名、生成随机前缀,再拼接目标目录。

推荐用 secure_filename()(来自 werkzeug.utils),但它只处理 ASCII 字符,对中文名会清空成空字符串。如需支持中文,得自己写逻辑:保留字母数字下划线点号,替换其余为下划线,再截断过长部分。

  • 永远用 os.path.join(UPLOAD_FOLDER, safe_name) 构造保存路径,不要用字符串拼接
  • 保存前检查 UPLOAD_FOLDER 是否存在,不存在就 os.makedirs()
  • 不建议直接覆盖同名文件,可加时间戳或 UUID 前缀,比如 f"{uuid4().hex}_{safe_name}"

上传大文件时为什么卡住或 413 错误

默认 Flask 限制请求体最大为 500KB,超限直接返回 413 Request Entity Too Large。这不是代码问题,是配置问题。

python-flask-vue-creator
python-flask-vue-creator

创建 Flask + Vue.js 全栈项目,采用单端口架构、uv 依赖管理、结构化日志和生产级前端设计。当用户要求以下操作时触发:创建新的 Flask+Vue 项目、搭建 Web 应用、构建全栈 Python+Vue 应用、初始化 Flask Web 项目、设置单端口 Flask 前后端项目。触发词:新建项目、创建项目、搭建项目、Flask项目、Vue项目。

下载

有两个地方要调:app.config['MAX_CONTENT_LENGTH'] 控制整个请求体大小(包括表单字段+文件),单位是字节;Nginx 或其他反向代理也得同步调大 client_max_body_size,否则请求根本到不了 Flask。

  • 设为 16 * 1024 * 1024(16MB)比较常见,按业务调整
  • 设太大有内存风险:Flask 默认把整个文件读进内存,大文件上传会吃光内存
  • 真要传 GB 级文件,得换流式处理(如用 file.stream.read(8192) 分块读),并配 Nginx 的 client_body_temp_path

怎么在上传后返回 JSON 而不是跳转页面

前端用 fetch 或 Axios 提交 FormData 时,后端必须返回 JSON,否则浏览器会尝试解析成 HTML 并跳转——哪怕你写了 return jsonify(...),只要前端没设 Content-Type 或没处理响应,就容易出问题。

关键点:后端用 jsonify(),前端用 response.json() 解析,且确保表单提交是异步的(阻止默认 submit 行为)。

  • 别在
    上直接写 action 提交,那必跳转;要用 JS 拦截
  • Flask 返回前,确保没有其他 print / print_debug 类语句干扰 JSON 格式
  • 上传失败时也返回标准 JSON(如 {"error": "No file selected"}),前端统一处理

Flask 文件上传本身不复杂,但每个环节都卡在细节上:表单属性漏写、filename 直接拼路径、大小限制没配、前端没拦截默认行为……最容易出问题的,其实是前后端对“上传完成”这件事的理解不一致。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
flask框架如何搭建
flask框架如何搭建

搭建步骤:1、安装Python和Pip;2、创建虚拟环境;3、安装Flask;4、创建Flask应用;5、运行应用;6、访问应用。想了解更多flask框架的相关内容,可以阅读本专题下面的文章。

2024.06.27

4515

8

Python Flask框架
Python Flask框架

本专题专注于 Python 轻量级 Web 框架 Flask 的学习与实战,内容涵盖路由与视图、模板渲染、表单处理、数据库集成、用户认证以及RESTful API 开发。通过博客系统、任务管理工具与微服务接口等项目实战,帮助学员掌握 Flask 在快速构建小型到中型 Web 应用中的核心技能。

2025.08.25

7024

10

Python Flask Web框架与API开发
Python Flask Web框架与API开发

本专题系统介绍 Python Flask Web框架的基础与进阶应用,包括Flask路由、请求与响应、模板渲染、表单处理、安全性加固、数据库集成(SQLAlchemy)、以及使用Flask构建 RESTful API 服务。通过多个实战项目,帮助学习者掌握使用 Flask 开发高效、可扩展的 Web 应用与 API。

2025.12.15

336

16

GoFrame框架Web开发与路由中间件
GoFrame框架Web开发与路由中间件

本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。

2026.11.17

0

15

GoFrame框架安装与gf命令行工具
GoFrame框架安装与gf命令行工具

本专题围绕GoFrame框架的安装与工具链配置展开,讲清Go版本要求、gf命令行的安装方式、代理镜像与依赖准备,说明项目初始化、热编译、交叉编译打包的做法,并整理安装阶段的常见报错与验证步骤。

2026.11.17

20

15

GoFrame框架零基础入门
GoFrame框架零基础入门

本专题整理GoFrame框架的入门知识,从模块化设计理念、环境准备到跑通第一个Web服务,讲清目录分层、配置加载、日志与中间件的用法,并对比Gin、Go-Zero的差异,帮助Go开发者建立整体认知。

2026.11.17

0

15

SQLAlchemy 一对多关系怎么建立
SQLAlchemy 一对多关系怎么建立

SQLAlchemy 一对多关系怎么建立?本专题整理父子表外键、relationship 双向映射、关联查询、级联删除和加载优化等相关文章,帮助你理解并实现常见的 ORM 关系建模。

2026.11.17

0

10

SQLAlchemy 如何增删改查
SQLAlchemy 如何增删改查

SQLAlchemy 如何增删改查?本专题整理 ORM 新增记录、条件查询、更新和删除、Session 事务提交与批量处理等实用文章,帮助你掌握 Python 数据库操作流程。

2026.11.17

0

11

SQLAlchemy ORM 模型怎么写
SQLAlchemy ORM 模型怎么写

SQLAlchemy ORM 模型怎么写?本专题整理模型类定义、Mapped 字段映射、主键与约束、表结构创建和常见报错的相关文章,帮助你从基础配置到实际建模逐步掌握 SQLAlchemy。

2026.11.17

0

16

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Flask-Migrate数据库迁移文档
Flask-Migrate数据库迁移文档

共0课时 | 0人学习

Flask官方快速入门文档
Flask官方快速入门文档

共0课时 | 0人学习