request()->file() 返回 null 的根本原因是 $_FILES 未被填充，常见于表单缺少 enctype="multipart/form-data"、非 POST 请求、name 不匹配或 PHP 上传限制触发。
file为什么为空">
request()->file() 返回 null 的常见原因
根本原因不是框架坏了，而是 request()->file() 依赖 PHP 原生的 $_FILES，而它只在 POST 请求且表单满足特定条件时才被填充。最常踩的坑是：前端没发对，或后端没配对。
- 前端
<form>缺少enctype="multipart/form-data"—— 这是最高频错误，缺了这句，浏览器根本不会把文件字段塞进$_FILES - 请求方法不是
POST（比如用了GET或PUT但没做服务端适配） - 文件 input 的
name属性和你调用request()->file('xxx')中的'xxx'不一致（大小写、下划线、中括号语法都要完全匹配） - 上传文件超过
php.ini限制：upload_max_filesize、post_max_size、max_execution_time等任一触发，PHP 会静默丢弃整个$_FILES，导致request()->file()为空
如何快速验证是否真的收到文件
别急着查 ThinkPHP 文档，先绕过框架看原生数据。在控制器里加一行：
dump($_FILES); die();
如果输出是空数组或 array(0) { }，说明问题出在请求层，和 ThinkPHP 无关；如果能看到文件信息，再查 request()->file() 的调用是否匹配。
- 注意：ThinkPHP 的
request()->file()是对$_FILES的封装，不支持通过PUT或PATCH请求体上传（除非你自己解析 raw body 并手动写入$_FILES） - 如果你用的是 axios/fetch，确保没把文件对象直接 JSON.stringify() 后发出去——那只会发个
[object File]字符串，后端收不到二进制流 - ThinkPHP 6+ 默认关闭了
file_get_contents('php://input')对文件上传的支持，所以不要指望用它读取 multipart 数据
ThinkPHP 6/7 中 file() 方法的参数陷阱
request()->file() 行为受参数影响极大，尤其当表单含多个文件或数组式命名时：
立即学习“PHP免费学习笔记（深入）”；
- 单文件：
request()->file('avatar')→ 要求 HTML 中<input type="file" name="avatar"> - 多文件同名：
<input type="file" name="photos[]" multiple>→ 必须用request()->file('photos')（不带方括号），返回数组；用request()->file('photos[]')会返回 null - 嵌套 name：
<input type="file" name="user[avatar]">→ ThinkPHP 不支持点号或中括号路径解析，request()->file('user.avatar')或request()->file('user[avatar]')都无效，只能用原生$_FILES['user']['avatar']手动取
上传失败但 request()->file() 不报错的问题
ThinkPHP 默认对 file() 返回值不做合法性校验，null 或假值不会抛异常，容易掩盖问题。建议每次使用前主动判断：
if (!$file = request()->file('cover')) {
return json(['code' => 400, 'msg' => '未收到 cover 文件']);
}
if (!$file->isValid()) {
return json(['code' => 400, 'msg' => '文件上传失败：' . $file->getError()]);
}
-
$file->isValid()会检查$_FILES中的error值，比如UPLOAD_ERR_NO_FILE（-1）、UPLOAD_ERR_INI_SIZE（1）等 - 即使
request()->file()返回了对象，$file->getError()也可能非空——例如用户点了上传但没选文件，或 PHP 静默截断了超大文件 - ThinkPHP 的
moveTo()在目标目录不可写时会抛异常，但file()本身从不报错，这点容易被忽略
request()->file() 变成 null。与其反复查文档，不如按顺序确认：表单 enctype → 请求方法 → name 属性 → $_FILES 原始输出 → error 码 → 目录权限。漏掉中间任何一步，都可能卡在“为什么是空”这个点上。 
