PbootCMS后台图片上传失败存储目录创建失败_完整排查路径_权限与路径
PbootCMS上传图片报"存储目录创建失败"，按以下路径排查。第一步确认目录存在且可写：网站根目录下`data/upload/`是否存在，不存在就手动创建，权限755，所有者www。第二步确认磁盘没满：`df -h`看使用率，满了清理。第三步确认PHP配置：file_uploads=On，upload_max_filesize合理，post_max_size大于上传大小。
data目录权限是最常见原因。宝塔环境下PHP运行用户是www，如果data目录所有者是root，PHP创建子目录失败。修复：`chown -R www:www /www/wwwroot/站点/data`。同时`chmod -R 755 /www/wwwroot/站点/data`。执行后在宝塔文件管理器里确认data目录属性显示www。
open_basedir限制。宝塔默认给每个站点设open_basedir为站点根目录，如果PbootCMS的上传路径配置到了站点外，创建目录被拒绝。检查config/config.php里upload_path，确认是相对路径且在站点内。临时关闭open_basedir测试：站点设置→PHP配置→open_basedir设为关闭，重启PHP。如果关闭后能上传，说明是路径问题，调整上传路径。
PHP临时目录不可写。上传文件先存到临时目录再移动到目标。phpinfo看upload_tmp_dir，默认/tmp。检查/tmp权限（1777），如果手动指定了其他目录，确认该目录存在且可写。`session_save_path`也类似，session目录不可写会导致登录和上传都异常。
SELinux（CentOS）。`setenforce 0`临时关闭测试，能上传了说明是SELinux上下文问题。永久解决：`semanage fcontext -a -t httpd_sys_rw_content_t "/www/wwwroot/站点/data(/.*)?"`然后`restorecon -Rv /www/wwwroot/站点/data`。不建议直接关SELinux，正确设置上下文更安全。
上传路径配置错误。config.php里`'upload_path' => 'data/upload/'`，不要写成`/data/upload/`（绝对路径从根开始找）或`http://域名/data/upload/`（URL不是路径）。路径末尾加斜杠。如果用了子目录部署（网站在子文件夹），路径要对应调整。
远程存储（OSS/COS）配置错误也可能报类似提示。如果开启了第三方存储，检查AccessKey、Bucket、Endpoint是否正确，网络能否连接存储服务。测试时先切回本地存储，确认本地能上传后再配远程存储，缩小问题范围。
图片本身的问题：格式不支持（只允许jpg/png/gif，传了webp/bmp）、文件太大（超过upload_max_filesize）、文件名含特殊字符或中文。传一张标准jpg小图测试，排除文件本身问题。
测试流程：传一张50KB的jpg→成功则是大图或格式问题→失败继续查。查PHP错误日志（宝塔→网站→日志→PHP错误日志），看上传时的具体报错，报错信息会指向根本原因。比如"Permission denied"就是权限，"No space left"就是磁盘满，"open_basedir restriction"就是目录限制。
更新时间：2026-08-26 18:09:48