小程序上传图片时$_FILES收不到数据，主因是前端wx.uploadFile的name字段与php中$_FILES键名不一致；需确保前后端字段名严格匹配，并检查目录权限、路径、nginx/apache上传限制及错误码。
小程序上传图片到 PHP 后端，关键不是“能不能传”，而是「$_FILES 为什么收不到」——绝大多数问题出在前端没发对、后端没配好，而不是 PHP 本身不支持。
小程序 wx.uploadFile 发送的文件字段名必须和 PHP 的 $_FILES 键名一致
小程序调用 wx.uploadFile 时，默认把文件塞进名为 file 的表单字段（除非你显式指定 name）。PHP 收到后，会把它放在 $_FILES['file'] 里。如果你后端代码写成 $_FILES['image'] 或 $_FILES['pic']，那就永远为空。
实操建议：
- 前端明确指定
name: 'file'，避免依赖默认值 - 后端用
var_dump($_FILES)看一眼实际结构，别猜 - 如果小程序改了
name（比如改成avatar），PHP 就得读$_FILES['avatar']，二者必须严格对应
move_uploaded_file 失败的常见原因和检查点
move_uploaded_file 返回 false 不代表文件没传上来，只说明「临时文件搬不动」。常见卡点：
立即学习“PHP免费学习笔记（深入）”；
- 目标目录不存在或 PHP 没有写权限（linux 下注意
www-data或nginx用户权限） - 目标路径是相对路径（如
'uploads/xxx.jpg'），但当前工作目录不是你预期的——一律用__DIR__ . '/uploads/xxx.jpg' - 临时文件已被自动清理（比如上传超时、Nginx 设置了
client_max_body_size限制，导致截断） -
$_FILES['file']['Error']不为 0：要先检查这个值，1是超upload_max_filesize，2是超MAX_FILE_SIZE隐藏域，6是找不到临时目录
Nginx / Apache 配置容易被忽略的上传限制
即使 PHP 的 upload_max_filesize 和 post_max_size 调大了，Web 服务器层照样能拦住大图：
- Nginx 必须设置
client_max_body_size 10M（放在http、server或location块中），否则 1MB 以上的图直接 413 Request Entity Too Large - Apache 默认没有 body 大小限制，但若启用了
mod_security，可能拦截 multipart 请求——可临时关掉测试 - https 环境下，某些 cdn（如腾讯云 CDN）会默认限制 POST body 大小，需单独配置
真正麻烦的不是上传逻辑本身，而是错误信息被层层吞掉：小程序只报“fail”，PHP 不打日志，Nginx 错误日志又没开——三者日志得一起看，缺一不可。