EP09. “上传媒体与文件类错误速查”
🔒 登录后可标记已读这篇笔记速查上传图片/文件、媒体库显示异常这类常见 WordPress 错误——大多跟文件权限设置有关。
重点内容
无法上传图片（图片显示成损坏占位符）
网站的图片突然全部变成损坏图标，上传新图片到媒体库也会报错。
成因：WordPress 安装的文件/目录权限不正确——网站不认得自己有没有权限新增/访问这些文件，常见于网站被黑或插件意外重写了权限设置之后。
修复步骤（用 SFTP）：
- 找到
wp-content目录里的uploads文件夹 - 右键选 File permissions，把 uploads 文件夹本身的 Numeric 值设成 744（让所有者能读写上传内容）
[截图：FTP 客户端的 File permissions 设置弹窗，Numeric value 输入框和 Recurse into subdirectories 勾选项]
- 再右键 uploads 文件夹选 File permissions，这次设成 644，勾选 Recurse into subdirectories，并选择只套用到文件（Apply to files）
- 保存后重新到媒体库测试上传
📌 如果还是不行，可以把 uploads 文件夹本身的权限值改试 755 而不是 744。
常见图片操作问题（对齐/裁切/图库）
不一定是技术性错误，很多时候只是不熟悉 WordPress 处理媒体的方式——比如不知道怎么对齐图片、调整大小/裁切、或用图库格式显示多张图片。花时间熟悉 WordPress 媒体库的操作界面即可解决。
Upload: Failed to Write File to Disk 错误
成因：多数情况是文件夹权限不正确——网站的每个文件/文件夹都有权限设置，服务器依此控制访问，权限不对会导致服务器没办法把文件写进对应目录。
解决方法：检查并修正相关文件夹的权限设置（参照上面无法上传图片的权限修复步骤）。
Destination Folder Already Exists 错误
安装插件/主题时出现，WordPress 会把上传的 zip 文件解压进一个跟压缩包同名的文件夹——如果同名文件夹已经存在，安装就会中止并显示：
Destination folder already exists. /home/user/example.com/wp-content/plugins/wpforms/
Plugin install failed.
解决方法：删除已存在的同名文件夹，再重新继续安装。
Missing a Temporary Folder 错误
WordPress 找不到 PHP 用来暂存临时文件的文件夹，会连带影响媒体上传、插件和主题安装。
解决方法：手动为 WordPress 指定一个临时文件夹，或请主机商代为设置修复。
HTTP Image Upload Error
上传图片/媒体到 WordPress 时看到 HTTP 错误提示，可能有多种成因。
特点：通常是暂时性的，几分钟内会自行恢复；但有时会持续出现需要进一步排查（比如内存限制、服务器资源问题）。
413 Request Entity Too Large 错误
多数主机商会把服务器配置成允许上传较大的图片和媒体文件，但有时这个上限不够高，导致上传大尺寸主题/插件文件（或媒体库里的大文件）失败，明确提示文件大小超过允许上限。
解决方法：调高服务器的 upload_max_filesize 和 post_max_size 限制（常需要联络主机商，或改 php.ini）。
"The Link You Followed Has Expired" 错误
尝试从后台上传 WordPress 主题或插件时出现。
成因：主机商对上传文件大小、以及脚本运行时长都有限制——文件太大或处理时间太长就会触发这个错误。
解决方法：依据具体成因，调高 PHP 的内存限制和文件上传大小限制。
"Sorry, This File Type Is Not Permitted for Security Reasons" 错误
WordPress 出于安全考量，默认限制某些文件类型上传（比如 SVG、PSD、自定义字体这类不常见格式），防止潜在的有害文件被上传进网站。
解决方法：需要哪种文件类型的支持，用插件或加一小段代码片段来启用该类型的上传权限。
Pluggable.php File Errors
Pluggable.php 文件包含一些核心 WordPress 函数，允许开发者在自己的代码里覆盖它们；如果某个插件或自定义代码片段没有正确处理这些函数，会看到类似：
Warning: Cannot modify header information – headers already sent by (output started at .../functions.php:1035) in .../pluggable.php on line 1179
影响：有时候网站还能继续用（只是警告），有时候是致命错误，直接让网站完全打不开。
通用文件与文件夹权限错误
WordPress 需要特定的文件/文件夹权限才能正常运作，大部分主机商装机时会预先设置好，但可能因意外操作或配置变动而改变。
标准权限：文件夹 755，文件 644（具体操作方式跟数值详见《500 Internal Server Error 完整解决指南》方案 7）。
常见误区
- ❌ 图片上传失败就怀疑是网络问题反复重试——多数是文件夹权限不对，先检查 uploads 文件夹权限（744/644/755），比反复重试更有效
- ❌ 权限设置图方便直接全部设成 777——这是严重的安全隐患，正确数值是文件夹 755、文件 644，多数主机会自动拦截 777 设置
- ❌ 想上传 SVG、自定义字体这类文件被拦，以为是上传功能坏了——这是 WordPress 刻意的安全限制，需要主动用插件或代码启用对应文件类型的支持
- 💡 安装插件/主题遇到「Destination folder already exists」，不用纠结原因，直接删掉那个同名文件夹重新安装就好
Sources
YouTube：
Blog / Website：
- 63 Most Common WordPress Errors and How to Fix Them — https://www.wpbeginner.com/common-wordpress-errors-and-how-to-fix-them/
- WordPress常见错误12个及解决办法 — https://www.wbolt.com/common-wordpress-errors.html