拖拽上传需监听drop事件并阻止默认行为，读取event.dataTransfer.files；ThinkPHP用request()->file()接收，注意字段名匹配、文件校验及JSON响应。
拖拽上传前端怎么监听 drop 事件
核心是阻止默认行为 + 读取 event.dataTransfer.files，否则浏览器会直接打开或跳转。常见错误是只绑了 dragover 却没加 preventDefault()，导致 drop 不触发。
实操建议：
- 给目标容器同时监听
dragover、drop、dragenter三个事件 -
dragover和dragenter中必须调用event.preventDefault()，否则 drop 会被浏览器拦截 -
drop里用event.dataTransfer.files拿文件列表，不是event.target.files - 支持多文件就直接遍历
files，单个上传可取files[0]
示例关键片段：
container.addEventListener('drop', (e) => {
e.preventDefault();
const files = e.dataTransfer.files; // 注意不是 e.target.files
uploadFiles(Array.from(files));
});
ThinkPHP 后端如何接收拖拽传来的文件
拖拽上传本质还是 multipart/form-data POST，和普通表单提交一致，ThinkPHP 的 request()->file() 完全能处理，不需要额外解析 raw body。
立即学习“PHP免费学习笔记（深入）”；
常见错误现象：
- 用
input('file')或request()->param('file')—— 这只能取字符串参数，拿不到文件对象 - 没检查
$_FILES是否为空，直接调move()导致报错Call to a member function move() on null - 前端用
FormData.append('upload_file', file)，后端却写request()->file('file')—— 字段名不匹配
实操建议：
- 确认前端
FormData中 append 的 key（如'file'），后端就用request()->file('file') - 用
isUploaded()判断是否成功接收到文件，再操作 - ThinkPHP 6 推荐用
$file->validate(['size'=>1024*1024*2, 'ext'=>'jpg,png,gif'])做前置校验
为什么拖拽上传后接口返回 400 或空响应
多数情况是 Nginx 或 PHP 配置拦住了大文件，或者前端没设好请求头，和 ThinkPHP 本身关系不大。
排查重点：
- Nginx 需检查
client_max_body_size，默认通常是 1M，拖拽常传大图/压缩包，建议设为20m - PHP 配置中
upload_max_filesize和post_max_size必须都大于目标文件，且后者 ≥ 前者 - 前端用
fetch时没加Content-Type: multipart/form-data—— 实际上不该手动设，让浏览器自动生成 boundary，手动设反而会破坏格式 - ThinkPHP 开启了强制 HTTPS 但前端用 HTTP 请求，导致预检（OPTIONS）失败，表现为无响应
上传成功后怎么返回 JSON 给前端用
ThinkPHP 默认返回 HTML 页面，拖拽上传需要纯 JSON 响应，否则前端 response.json() 会报错。
关键点：
- 控制器方法末尾必须显式 return
json($data)，不能 echo 或 dump - 别在中间用
exit、die或halt()，会中断框架响应流程 - 如果用了验证器，错误时要统一用
ValidateException抛出，配合全局异常处理返回 JSON，否则validate()->batch()->check()失败可能返回视图 - 路径权限问题：ThinkPHP 6 默认上传到
runtime/upload，确保该目录可写，否则move()返回 false，但不会抛异常，需手动判断
示例返回：
return json([ 'code' => 0, 'msg' => '上传成功', 'data' => ['url' => $info->getSaveName()] ]);
文件名拼接 URL 时注意路径分隔符，Windows 下 getSaveName() 返回反斜杠，需替换为正斜杠才能被 Web 访问。
