根本原因是Linux文件系统权限不足，Web服务器用户（如www-data、nginx）对上传目录缺少写权限，导致move_uploaded_file()失败。需确认Web用户、上传路径，用chown赋予对应用户所有权，避免chmod 777，注意SELinux限制。
上传失败提示 无法写入目录 的根本原因
这不是 ThinkPHP 的 bug，而是 Linux 文件系统权限没给到位。Web 服务器（比如 nginx 或 apache）运行时用的是某个系统用户（常见是 www-data、nginx 或 apache），它必须对上传目标目录有 w（写）权限，否则 move_uploaded_file() 会直接失败，ThinkPHP 只是把底层错误转成中文提示。
确认 Web 服务运行用户和上传目录路径
先别急着 chmod 777，得先搞清谁在操作、往哪写：
- 查 Web 用户：
ps aux | grep nginx（看主进程 USER 列）或ps aux | grep apache；Nginx 常见是nginx，Apache 在 Ubuntu 是www-data，CentOS 是apache - 查 ThinkPHP 上传目录：默认是
runtime/upload，但实际由配置项upload.root或代码里传的$path决定，务必检查你调用think\File::move()或request()->file()->move()时指定的路径 - 用
ls -ld /path/to/upload看目录当前权限和所属用户/组
chmod 和 chown 怎么配才安全
只加写权限不解决问题，关键要让 Web 用户真正“拥有”该目录或至少能写入。以下组合最常用且可控：
- 推荐方案（最小权限）：
chown -R www-data:www-data /var/www/yourapp/runtime/upload（Ubuntu Apache/Nginx）或chown -R nginx:nginx /var/www/yourapp/runtime/upload（CentOS Nginx） - 如果上传目录在
public/下（比如public/uploads），且需被 Web 直接访问，确保父目录可执行：chmod 755 /var/www/yourapp/public，上传目录本身chmod 755即可，不用 777 - 绝对避免：
chmod 777整个runtime目录——这等于把缓存、日志、会话全暴露给任意脚本，极易被利用 - 注意 SELinux：CentOS 7+ 默认开启，即使权限正确也可能拦截。临时验证是否 SELinux 导致：
setenforce 0，若上传恢复，则需打标：chcon -R -t httpd_sys_rw_content_t /path/to/upload
ThinkPHP 自带上传方法的隐藏坑
ThinkPHP 的 move() 方法看似简单，但几个参数细节常被忽略，导致权限判断绕过或路径错位：
立即学习“PHP免费学习笔记（深入）”；
- 第二个参数
$savename若传了完整路径（如/var/www/.../xxx.jpg），它会跳过根目录拼接逻辑，直接写入——这时你改的是runtime/upload权限，但文件实际写到了别处，自然报错 - 正确做法：只传相对名（如
'2024/abc.jpg'），让框架用upload.root配置自动拼路径；否则手动确保目标目录存在且权限正确 - Windows 开发环境没问题，一上 Linux 就挂？大概率是开发机没开权限校验，而生产环境 PHP 配置中
open_basedir或disable_functions限制了move_uploaded_file，检查phpinfo()输出里的相关项
真正卡住人的，往往不是不会设权限，而是没意识到 Web 进程用户和你 SSH 登录用户根本不是同一个，更没去查它到底想往哪写。目录存在、名字没错、报错还一样——八成是 chown 没对人，或者 SELinux 在背后默默拦着。
