本质是PHP无法将临时文件写入目标路径，常见原因包括目标目录不存在、父目录不可写、权限不足、SELinux/AppArmor限制、Docker挂载权限问题或Windows驱动器ACL未授权。
为什么 move_uploaded_file 报 “failed to open stream” 错误
这个错误本质是 PHP 无法把临时文件写入目标路径，不是上传失败，而是移动阶段出问题。常见原因不是权限不对，就是路径根本不存在或不可写——尤其容易忽略父目录的可写性。
检查目标目录是否存在且可写（最常漏掉的一步）
PHP 进程需要对 整个路径链 都有写权限，包括每一级父目录。比如想存到 /var/www/uploads/2024/06/file.jpg，不仅 uploads 要存在，2024 和 06 也得提前建好，且 PHP 用户（如 www-data 或 apache）能进入并创建文件。
- 用
is_dir()和is_writable()检查目标目录：var_dump(is_dir('/var/www/uploads')); // 必须 true<br>var_dump(is_writable('/var/www/uploads')); // 必须 true - 如果目录不存在，用
mkdir($path, 0755, true)创建多级目录，true表示递归创建父级 - Linux 下确认属主：运行
ps aux | grep apache或ps aux | grep php-fpm看实际用户，再用chown -R www-data:www-data /var/www/uploads
确认临时文件是否还有效（上传超时或配置限制）
$_FILES['xxx']['tmp_name'] 是个临时路径，PHP 在脚本结束或上传超时后会自动清理它。如果中间做了耗时操作（比如大文件校验、sleep、远程请求），可能导致调用 move_uploaded_file 时临时文件已被删。
- 立刻检查
$_FILES['xxx']['error']值：
—UPLOAD_ERR_OK（0）才表示上传成功；
—UPLOAD_ERR_NO_FILE（4）说明没传文件；
—UPLOAD_ERR_EXTENSION（8）可能被 Suhosin 或其他扩展拦截 - 检查
upload_max_filesize和post_max_size是否足够（注意单位：10M ≠ 10000000 字节） - 避免在
move_uploaded_file前做重命名、数据库插入等长流程；先移走再处理
Windows 下路径分隔符和驱动器权限问题
Windows 上容易因反斜杠转义或盘符权限出错。例如 C:\inetpub\wwwroot\uploads 中，如果 IIS 应用池身份没被授予该目录的“修改”权限，也会报同样错误。
立即学习“PHP免费学习笔记（深入）”；
- 统一用正斜杠或
DIRECTORY_SEPARATOR拼接路径：$dest = __DIR__ . '/uploads/' . $filename; - 在 IIS 管理器中右键目标文件夹 → “编辑权限” → 添加应用池对应用户（如
IIS AppPool\DefaultAppPool），勾选“修改” - 禁用 Windows 的“简单文件共享”，确保 ACL 权限生效
真正卡住的地方往往不是函数本身，而是路径的“存在性”和“可写性”被当成理所当然——尤其是嵌套子目录未创建、SELinux 或 AppArmor 限制、Docker 容器挂载目录权限不足这些场景，连 is_writable() 都可能返回 true 却实际失败。
