PbootCMS后台图片上传提示存储目录创建失败_权限_SELinux_open_basedir全排查
PbootCMS上传图片报"存储目录创建失败"，按以下完整路径排查，覆盖所有可能原因。
1. 目录存在性检查 - 网站根目录下`data/upload/`是否存在。 - 不存在手动创建：mkdir data/upload，权限755，所有者www。 - PbootCMS上传路径在config/config.php里，确认`'upload_path' => 'data/upload/'`正确。
2. 目录权限检查（最常见） - 宝塔环境PHP运行用户是www。 - `chown -R www:www /www/wwwroot/站点/data` - `chmod -R 755 /www/wwwroot/站点/data` - 用宝塔文件管理器看data目录属性，所有者显示www。
3. 磁盘空间检查 - `df -h`看根分区，100%满了任何写入都失败。 - 清理runtime缓存、旧备份、大日志。 - 至少留1G空闲空间。
4. open_basedir限制 - 宝塔默认给站点设open_basedir为站点根目录。 - 如果上传路径配置到了站点外，被拒绝。 - 检查config.php上传路径，确认在站点根目录内。 - 临时关闭open_basedir测试：站点设置→PHP配置→open_basedir→关闭。能上传就是路径问题。
5. SELinux（CentOS） - `setenforce 0`临时关闭测试。 - 能上传说明是SELinux上下文问题。 - 永久修复：`semanage fcontext -a -t httpd_sys_rw_content_t "/www/wwwroot/站点/data(/.*)?"`然后`restorecon -Rv /www/wwwroot/站点/data`。 - 不建议直接关SELinux，正确配置更安全。
6. PHP配置检查 - `file_uploads = On`必须开启。 - `upload_max_filesize`设合理值（如10M）。 - `post_max_size`大于upload_max_filesize。 - `upload_tmp_dir`（临时目录）存在且可写，默认/tmp权限1777。 - 宝塔PHP设置里改，改完重启PHP。
7. PHP扩展检查 - GD库：图片处理需要，`php -m|grep gd`确认。 - fileinfo：MIME类型检测需要。 - 缺扩展在宝塔PHP设置→安装扩展里装。
8. 远程存储配置（如果开启了OSS/COS） - 检查AccessKey、Bucket、Endpoint是否正确。 - 测试网络能否连接存储服务。 - 临时切回本地存储测试，排除远程存储问题。
9. 图片本身问题 - 格式：只允许jpg/png/gif，传了webp/bmp/tiff可能失败。 - 大小：超过upload_max_filesize。 - 文件名：含特殊字符或中文，部分环境编码问题。 - 传一张50KB标准jpg测试，排除文件本身。
10. 代码层面检查 - 上传目录路径配置错误（config.php）。 - 上传类代码被修改过，路径拼接错误。 - 从官方安装包对比上传相关文件，恢复被改的文件。
11. 错误日志查看 - 宝塔→网站→对应站点→日志→PHP错误日志。 - 上传时看具体报错：Permission denied（权限）、No space left（磁盘满）、open_basedir restriction（目录限制）。 - 报错信息直接指向原因。
测试流程： 传50KB jpg→成功→大图/格式问题；失败→查PHP错误日志→根据报错修。 按顺序排查，一定能找到原因。修复后建议把data目录加入定期备份，图片是网站重要资产。
更新时间：2026-08-26 17:22:00