WordPress图片上传失败修复

你是不是也遇到过这种情况？

好不容易找到一张完美配图，兴冲冲地上传到WordPress后台，结果进度条卡住，最后弹出一个冷冰冰的错误提示。

一瞬间，所有写作的灵感都被浇灭了。更气人的是，你完全不知道问题出在哪里。

别急，今天我就用最直白的话，带你一步步排查，把这个问题彻底解决掉。看完你就能自己动手搞定，再也不用求人。

一、先别慌，从最简单的开始检查

很多问题其实出在细节上。我们先做几个快速检查，说不定一分钟就解决了。

1. 检查你的图片“体重”超标没

这是最常见的原因。你的服务器对单次“搬运”的东西有重量限制。

怎么检查？

右键点击你电脑里的图片文件，看看“属性”。

如果图片大小超过了你服务器的限制，就会上传失败。

怎么解决？

很简单，给图片“减减肥”。

• 用电脑自带的“画图”工具打开，另存为一下，体积会小很多。
• 或者用在线工具，比如TinyPNG，压缩效果很好，画质损失也小。

避坑提醒：博客图片宽度一般1200像素就够了，别传原图，又慢又占地方。

2. 看看服务器给你的“搬运额度”

服务器有两个关键限制：单个文件大小和一次上传的总大小。

怎么查看和修改？

你需要修改一个叫 `php.ini` 的配置文件。

如果你有服务器管理面板（比如cPanel），里面通常有文件管理器，找到 `php.ini`。

找到这三行，把数字改大：

``` upload_max_filesize = 64M post_max_size = 64M max_execution_time = 300 ```

改完后，一定要重启一下你的网站服务器，设置才会生效。

如果你不会操作，直接联系你的主机客服，把上面三行代码发给他，让他帮你改。

二、检查“搬运工”的权限对不对

想象一下，你雇了个搬运工（WordPress），但他没有进仓库（服务器目录）的钥匙。

1. 给文件夹正确的“钥匙”

WordPress上传的图片，一般都放在 `/wp-content/uploads/` 这个文件夹里。

这个文件夹，以及里面的年月子文件夹，需要有“写入”权限。

具体怎么做？

通过FTP工具（比如FileZilla）连接你的网站。

找到 `wp-content` 文件夹，右键点击“权限”（或“文件属性”）。

把权限数字改成 755。

对 `uploads` 文件夹做同样操作，并且勾选“应用到子目录”。

这样，WordPress就有权限在里面存东西了。

2. 看看“主人”对不对

文件夹的“所有权”也可能出错。这指的是服务器进程（比如php-fpm）和文件夹是不是同一个“主人”。

这个稍微复杂点，如果你改了权限还不行，可以联系主机商，告诉他们：“请帮我检查一下网站目录的所有权（ownership）是否正确。”他们一听就懂。

三、排除插件和主题的“打架”问题

有时候，问题不出在WordPress本身，而是你安装的某个“小工具”在捣乱。

1. 关掉所有插件试试

这是排查问题的黄金法则。

在WordPress后台，停用所有插件。

然后立刻去试试上传图片。

如果成功了，那就说明是某个插件惹的祸。

接下来，一个一个重新激活插件，每激活一个，就试一次上传图片。

当上传再次失败时，最后激活的那个插件就是“罪魁祸首”。找到它，换一个同类插件，或者看看有没有更新版本。

2. 换个“衣服”看看

主题也可能导致冲突。

在后台“外观”里，暂时切换到WordPress自带的默认主题（比如Twenty Twenty-Four）。

然后再试试上传。

如果换了主题就好了，那问题就出在你原来的主题上。联系主题的作者或客服，向他们反馈这个问题。

四、终极方案：修改“搬运路线”

如果以上方法都试了还是不行，我们可以修改WordPress处理图片上传的“内部路线”。

1. 修改网站的“身份证”

在网站根目录，找到 `wp-config.php` 文件，用代码编辑器打开。

在 `/ 好了！请不要再继续编辑。请保存本文件。 /` 这行代码之前，加入下面三行：

``` define('WP_MEMORY_LIMIT', '256M'); define('WP_MAX_MEMORY_LIMIT', '256M'); define('IMAGE_EDIT_OVERWRITE', true); ```

第一行是增加可用内存，第二行是增加最大内存，第三行是让图片编辑时直接覆盖原图，避免产生多余文件。

保存文件，上传回去覆盖原文件。

2. 最后的“重置大法”

如果所有方法都无效，可能是多媒体数据库索引出错了。

别担心，有个插件可以一键修复。

安装并激活一个叫 “Regenerate Thumbnails” 的插件。

在“工具”菜单里找到它，运行一次“重新生成缩略图”。

这个过程会重建所有图片的数据库记录，相当于给图片库做了一次全面体检和修复。

好了，方法就是这些。

我建议你从第一部分开始，按顺序往下试。大部分问题在前两步就能解决。

别被那些专业术语吓到，说白了就是检查图片大小、改改服务器设置、关掉有问题的插件。

现在就去试试吧，搞定之后，你会发现自己又变强了一点。下次遇到问题，你就能淡定地自己排查了。