讲师中心 微信公众号
AI工具推荐 视频效率加速

HTML中enctype multipart/form-data的使用场景与文件上传配置

阿婷同学_6074

阿婷同学_6074

发布时间:2026-05-01 10:18:26

|

843人浏览过

|

来源于php中文网

原创

enctype="multipart/form-data" 是文件上传的强制要求,必须显式设置在 form 标签上且 method 为 POST;其他编码格式无法传输二进制文件,accept 仅为前端提示,后端须校验 MIME 类型、魔数及文件大小等。

html中enctype multipart/form-data的使用场景与文件上传配置

enctype="multipart/form-data" 是文件上传的强制要求,不是可选项

只要表单里有 <input type="file">,就必须在 <form> 标签上显式写 enctype="multipart/form-data",且 method 必须为 POST。浏览器不会自动补全,也不接受默认值——设错或漏设,后端根本收不到文件对象(比如 req.file 或 request.files 为空)。

常见错误现象:

  • 前端选了文件、点了提交,但后端日志里没打印出任何文件字段
  • 用 application/json 提交,后端收到的是 [object File] 字符串
  • 用 application/x-www-form-urlencoded,文件内容被 URL 编码成乱码,原始字节丢失

原因很简单:multipart/form-data 是唯一能携带原始二进制分块(含 Content-Disposition 和边界分隔符)的编码格式;其他类型压根不支持二进制边界结构。

form 标签上写 enctype,不是 input 或 button 上

enctype 属于 <form> 的属性,只对整个表单生效。它不会因为某个 input 是 type="file" 就自动触发,也不会继承自父级或通过 JS 动态添加后“追加生效”——必须在 HTML 渲染时就存在。

立即学习“前端免费学习笔记(深入)”;

实操建议:

  • 检查源码,确认 <form action="/upload" method="post" enctype="multipart/form-data"> 这一行完整存在
  • 不要写成 <input enctype="...">,这毫无意义
  • 如果用 JavaScript 动态创建表单,记得在 appendChild 前给 form 元素设置 enctype 属性:form.enctype = "multipart/form-data"
  • 使用 fetch + FormData 时不用手动设 enctype,浏览器会自动加请求头 Content-Type: multipart/form-data; boundary=...

accept 属性只是客户端提示,不能替代后端校验

<input type="file" accept="image/png,image/jpeg"> 能在部分浏览器中过滤文件类型选择弹窗,但它完全可被绕过:用户可以手动修改 HTML、用 curl 提交、或拖拽非允许类型文件。所以它只影响体验,不提供安全保证。

anything-to-html
anything-to-html

将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML,替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度,HTML 能同时承载排版、表格、SVG 等。

下载

真正起作用的只有后端:

  • 检查 Content-Type 头(如 image/jpeg),而非仅靠扩展名
  • 读取文件魔数(magic bytes),比如 PNG 文件开头是 89 50 4E 47
  • 限制总请求体大小(如 Node.js 的 multer.limits.fileSize,Flask 的 MAX_CONTENT_LENGTH)
  • 重命名文件(避免 ../../etc/passwd 类路径遍历),用 secure_filename() 或等效函数处理原始名

不校验 MIME 或魔数,单靠 accept 或后缀名白名单,很容易被传入伪装的 WebShell 文件。

FormData 对象内部已隐式使用 multipart/form-data

当用 JavaScript 构造 FormData 并 append 文件时,例如:

const fd = new FormData();
fd.append("avatar", fileInput.files[0]);
fetch("/upload", { method: "POST", body: fd });

浏览器会自动以 multipart/form-data 编码发送,且生成合法的 boundary。你不需要、也不能手动设置 Content-Type 请求头——一旦显式设置了,浏览器反而会禁用自动 multipart 封装,导致服务端解析失败。

容易踩的坑:

  • 写了 headers: { "Content-Type": "multipart/form-data" } → 错误,会丢掉 boundary,后端收不到文件
  • 把 fileInput.files[0] 转成 blob 再 append → 没问题,FormData 仍能正确封装
  • append 普通字符串字段(如 fd.append("name", "Alice"))→ 它会和文件一起打包进同一个 multipart 请求,服务端可同时拿到文本和二进制

边界(boundary)是随机生成的,每次请求都不同,服务端解析器(如 multer、Django 的 request.FILES)依赖它来切分各个 part —— 这个细节前端不用管,但得知道它真实存在且不可省略。

相关文章

HTML速学教程(入门课程)
HTML速学教程(入门课程)

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

下载

相关标签:

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

热门AI工具

更多
Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

相关专题

更多
C语言变量命名
C语言变量命名

c语言变量名规则是:1、变量名以英文字母开头;2、变量名中的字母是区分大小写的;3、变量名不能是关键字;4、变量名中不能包含空格、标点符号和类型说明符。php中文网还提供c语言变量的相关下载、相关课程等内容,供大家免费下载使用。

3169

2023.06.20

c语言入门自学零基础
c语言入门自学零基础

C语言是当代人学习及生活中的必备基础知识,应用十分广泛,本专题为大家c语言入门自学零基础的相关文章,以及相关课程,感兴趣的朋友千万不要错过了。

2308

2023.07.25

c语言运算符的优先级顺序
c语言运算符的优先级顺序

c语言运算符的优先级顺序是括号运算符 > 一元运算符 > 算术运算符 > 移位运算符 > 关系运算符 > 位运算符 > 逻辑运算符 > 赋值运算符 > 逗号运算符。本专题为大家提供c语言运算符相关的各种文章、以及下载和课程。

1240

2023.08.02

c语言数据结构
c语言数据结构

数据结构是指将数据按照一定的方式组织和存储的方法。它是计算机科学中的重要概念,用来描述和解决实际问题中的数据组织和处理问题。数据结构可以分为线性结构和非线性结构。线性结构包括数组、链表、堆栈和队列等,而非线性结构包括树和图等。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

1198

2023.08.09

c语言random函数用法
c语言random函数用法

c语言random函数用法:1、random.random,随机生成(0,1)之间的浮点数;2、random.randint,随机生成在范围之内的整数,两个参数分别表示上限和下限;3、random.randrange,在指定范围内,按指定基数递增的集合中获得一个随机数;4、random.choice,从序列中随机抽选一个数;5、random.shuffle,随机排序。

1356

2023.09.05

c语言const用法
c语言const用法

const是关键字,可以用于声明常量、函数参数中的const修饰符、const修饰函数返回值、const修饰指针。详细介绍:1、声明常量,const关键字可用于声明常量,常量的值在程序运行期间不可修改,常量可以是基本数据类型,如整数、浮点数、字符等,也可是自定义的数据类型;2、函数参数中的const修饰符,const关键字可用于函数的参数中,表示该参数在函数内部不可修改等等。

2158

2023.09.20

c语言get函数的用法
c语言get函数的用法

get函数是一个用于从输入流中获取字符的函数。可以从键盘、文件或其他输入设备中读取字符,并将其存储在指定的变量中。本文介绍了get函数的用法以及一些相关的注意事项。希望这篇文章能够帮助你更好地理解和使用get函数 。

3460

2023.09.20

c数组初始化的方法
c数组初始化的方法

c语言数组初始化的方法有直接赋值法、不完全初始化法、省略数组长度法和二维数组初始化法。详细介绍:1、直接赋值法,这种方法可以直接将数组的值进行初始化;2、不完全初始化法,。这种方法可以在一定程度上节省内存空间;3、省略数组长度法,这种方法可以让编译器自动计算数组的长度;4、二维数组初始化法等等。

15715

2023.09.22

OpenJDK JVM参数怎么调优
OpenJDK JVM参数怎么调优

Java应用运行缓慢,如何调整JVM参数?本专题介绍OpenJDK JVM性能调优的基本流程,涵盖性能指标确认、运行数据采集、内存配置和垃圾回收分析,帮助你先定位瓶颈,再通过对照测试验证效果,避免直接套用参数而影响应用稳定性。

0

2026.10.16

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
GDB 17.2 官方文档集合
GDB 17.2 官方文档集合

共0课时 | 0人学习

Bootstrap 入门安装配置
Bootstrap 入门安装配置

共0课时 | 0人学习

38+ PhpStorm 提示和技巧
38+ PhpStorm 提示和技巧

共1课时 | 224人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn