应先判断request()->file('avatar')是否为null，再检查$file->getsize() > 0；null表示未选文件、表单无enctype、name错误或php配置超限，0字节需单独校验。
ThinkPHP中$_FILES为空但没报错，怎么判断上传失败？
上传表单提交后$_FILES数组存在但$_FILES['file']['error'] === UPLOAD_ERR_NO_FILE，说明用户根本没选文件——这不是服务器错误，而是前端未触发选择。ThinkPHP的request()->file()在无文件时直接返回null，不是空数组也不是假值，容易被empty()误判。
- 永远别用
empty(request()->file('avatar'))判断，它对null返回true，但也会把合法的0字节文件（极少见）误判为“没传” - 正确方式是先检查
request()->file('avatar')是否为null，再查->getError() - 如果用了
validate(['size'=>1])这类规则，0字节文件会因校验失败被拦截，但getError()返回的是验证错误，不是上传错误，需区分处理
request()->file()返回null的三种真实原因
不是所有null都代表“用户没选”，得结合上下文看：
-
表单没带
enctype="multipart/form-data"：此时$_FILES为空，request()->file()必然null，且$_POST数据仍能收到 -
字段名写错：比如HTML里写
name="img"，PHP里却调request()->file('avatar')，返回null但无提示 -
PHP配置限制：如
upload_max_filesize设为2M，用户传了5M文件，$_FILES['x']['error']为UPLOAD_ERR_INI_SIZE，ThinkPHP内部会跳过解析，request()->file()也返回null
建议在控制器开头加一行调试：dump($_FILES); exit;，确认原始数据状态再往下走。
过滤空文件（0字节）的可靠写法
用户可能选了文件但内容为空（比如新建txt未保存就上传），这种文件request()->file()能拿到对象，但->getSize() === 0。不能只靠->isValid()，因为它只检查上传过程是否成功，不检查内容。
- 必须显式调用
$file->getSize() > 0，0字节文件->isValid()仍返回true - 如果启用了验证器，
size:1规则可拦截0字节，但注意：它报的是“文件大小不能小于1字节”，错误信息不直观，前端难区分是没选还是真传了空文件 - 安全起见，入库前建议再用
file_get_contents($file->getRealPath(), false, null, 0, 1) === ''二次确认（仅当怀疑文件系统异常时）
$file = $this->request->file('logo');
if (is_null($file)) {
$this->error('请先选择文件');
}
if ($file->getSize() === 0) {
$this->error('不能上传空文件');
}
上传失败错误码对应处理策略
ThinkPHP封装了$_FILES['x']['error']，但没暴露原始码。要精准响应，得从$file对象里捞：
-
$file->getError()返回字符串，如"上传文件大小超出限制"，适合直接提示用户 - 若需分支逻辑（比如
UPLOAD_ERR_NO_FILE引导重选，UPLOAD_ERR_PARTIAL提示网络问题），得用$file->getUploadError()获取原始整型错误码 -
UPLOAD_ERR_EXTENSION常被忽略：某些PHP环境禁用了fileinfo扩展，导致getMimeType()失败，ThinkPHP会静默返回null，此时$file->getUploadError()为0，但$file->getMime()为空
空文件过滤真正麻烦的不是代码，而是得同时覆盖表单缺失、配置超限、扩展禁用、用户误操作四类场景——漏掉任意一种，前端都会看到“上传失败”但不知道为什么。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
