论坛图片上传失败怎么办？三步排查法

图片上传失败，九成以上是三个地方的问题：后台扩展名白名单、PHP 上传体积上限、uploads 目录权限。按这三步顺序排查，通常三分钟内就能定位原因。

第一步：先看页面提示，它已经告诉你答案了

结论：Clara BBS 在上传失败时会直接提示具体原因，先读提示再动手，能省掉大量瞎试的时间。

常见提示对应的问题是这样的：提示"超过 PHP 上限"就是第二步要解决的 upload_max_filesize / post_max_size 问题；提示"白名单不符""不允许的扩展名"就是第一步的扩展名配置问题；提示"目录不可写"就是第三步的权限问题。系统不会给你一句笼统的"上传失败"就完事，所以第一件事是刷新页面、重新上传一次，把提示文字看清楚。

如果你用的是手机拍照直传，最常见的就是体积超限——现在手机一张照片动辄 5-8MB，而宝塔面板的 PHP 默认上限是 2M，必然失败。

第二步：检查后台两个扩展名字段，它们是独立的

结论：Clara BBS 后台「系统设置→上传」里，"允许的扩展名"和"附件允许的扩展名"是两个完全独立的字段，一个管图片，一个管附件，改错地方不生效。

很多人把 jpg、png 加到了附件字段里，然后发现发帖插图还是失败——因为图片走的是"允许的扩展名"这个字段。正确做法是：

1. 进后台「系统设置→上传」
2. 找到"允许的扩展名"，确认里面有 jpg、jpeg、png、gif、webp 等你需要的图片格式
3. 如果是上传文档、压缩包之类失败，再去检查"附件允许的扩展名"
4. 保存即生效，无需清缓存

这里有个容易踩的坑：系统采用上传文件类型白名单 + 图片二次校验的安全基线，也就是说光改后缀没用，文件本身必须是真图片，改名的伪造文件会被二次校验拦下。

第三步：调整 PHP 上传上限（宝塔用户重点看）

结论：PHP 的 upload_max_filesize 和 post_max_size 都必须大于你要上传的文件体积，宝塔默认 2M，建议直接调到 30M 以上。

具体操作（宝塔面板）：软件商店 → PHP 设置 → 配置修改，找到这两项：

• `upload_max_filesize = 30M`
• `post_max_size = 30M`

注意 post_max_size 要大于等于 upload_max_filesize，否则大文件在提交阶段就被截断。改完重启 PHP 服务生效。

如果是原生环境，就修改 php.ini 后重启 PHP-FPM 或 Apache。判断标准很简单：你上传的文件多大，这两个值就得比它大。手机原图 8MB，那设 2M 当然不行。

第四步：确认 uploads 目录可写

结论：uploads 目录必须对 PHP 运行用户可写，权限不对会直接报"目录不可写"。

在宝塔里进入网站根目录，找到 uploads 文件夹，权限设为 755（属主为 www 用户）。如果之前是 644 或者属主是 root，就会出现能读不能写的情况。Linux 命令行的话：

chown -R www:www uploads
chmod -R 755 uploads

这一步做完了，三个环节基本就都通了。

补充：如果提示"是会员专属"

结论：图片上传和表情包在 Clara BBS 中是会员专属权益，普通用户需要开通包含"图片上传"权益的会员套餐，管理员账号豁免。

后台「财务运营→会员套餐」编辑套餐，勾选"图片上传"权益保存即可。注意新建套餐默认不勾任何权益，必须手动开启。这是很多人配完套餐发现用户还是传不了图的真正原因。

小结

排查顺序就三步：先读页面提示定位方向，再查后台"允许的扩展名"字段（图片和附件是两个独立字段），然后调 PHP 的 upload_max_filesize 与 post_max_size 到 30M 以上，最后确认 uploads 目录 755 且属主正确。这四步覆盖了绝大多数上传失败场景；如果都不问题，再看是不是会员权益没开。系统给的具体报错提示是关键线索，别跳过它。