网站维护期间，编辑在后台发布文章时遇到图片上传失败，这类情况并不少见。很多人的第一反应是服务器存储不够了，也有人怀疑目录权限被改动，还有的会认为程序本身出了故障。但真实原因常常不是单独某一项，而是多个环节同时出了问题。图片上传这条路径要依次经过浏览器、程序、临时目录、目标目录和存储空间，其中任何一个节点异常，最终都会表现为同样的上传失败。因此，与其凭直觉去猜，不如按照固定顺序逐项检查。
先确认存储空间是否已经占满。这是最容易被忽视、却也最容易核实的一项。服务器磁盘写满之后，程序无法创建新文件，上传自然会失败。可以登录服务器查看磁盘使用率，重点不只是系统盘，还要看图片实际存放的数据盘或挂载目录。有些环境会把上传目录单独挂载，系统盘还有余量，但图片盘已经满了。另外也要留意inode占用情况，即使剩余空间看起来不少，小文件过多同样可能导致无法写入。
确认空间正常后，再检查目录权限。图片上传失败经常和权限变动有关，比如运维调整过目录属主、部署脚本重置了权限，或者迁移后目录归属发生了变化。需要确认的是运行程序的账号对上传目录是否具备写权限，而不只是看目录是否存在。权限检查要覆盖三层：目录本身是否可写、目录属主与程序运行账号是否匹配、上级目录是否可进入。很多时候目录权限是755，程序账号不是属主，照样写不进去。
接着核对上传大小限制。这一项容易被漏掉，因为空间和权限都正常，图片却依然传不上去。上传限制通常分布在几个位置：程序框架的配置、Web服务器对请求体的限制，以及PHP等运行环境的单文件大小和总请求大小限制。如果编辑上传的图片超过限制，程序可能在接收阶段就中断了，表现为上传失败或转圈后没有反应。需要把这几处限制对照检查，而不是只改一个地方。
最后检查临时目录是否可写。图片上传一般先落到系统临时目录，再移动到目标目录。临时目录空间不足、权限不对或路径配置错误，都会让上传在中间环节失败。可以确认临时目录是否存在、剩余空间是否充足、程序账号是否有写权限。有些环境临时目录被清理策略清空后没有重建，也会引发问题。
为了减少反复排查，可以整理一张顺序表，把服务端配置和程序侧设置分开。服务端侧包括磁盘空间、inode占用、目录权限、临时目录状态、Web服务器请求体限制；程序侧包括上传大小配置、允许的文件类型、上传路径设置、程序运行账号。排查时先服务端后程序侧，先看整体资源再看具体目录，能更快缩小范围。
修复之后不要只看一次上传成功就结束。建议用不同大小的图片分别测试，确认小图和大图都能正常上传；再让编辑在实际发布流程中走一遍，确认图片能正常显示和保存。日常维护中，可以把磁盘使用率、上传目录权限、临时目录状态纳入定期巡检，设置合理的告警阈值，在空间接近上限前就处理。it数运在网站维护服务中通常会把这类检查项纳入日常巡检，目的不是等故障发生后再救火，而是提前发现隐患。把排查顺序固定下来，图片上传失败就不再是每次都靠运气解决的问题。
