WordPress 报错“temp-write-test”怎么办？快速修复指南

在使用 WordPress 的过程中，可能会遇到这样一个错误提示：“temp-write-test failed”或“无法创建临时文件”。这个问题常出现在安装插件、更新主题、上传图片等操作时，影响网站的正常运行。本文将介绍这种错误出现的原因，并提供一套完整的排查和修复方案，帮助尽快解决问题。

常见报错场景

• 安装插件失败
• 上传媒体文件时报错
• WordPress 更新无法进行
• 批量导入导出时操作中断

这些操作背后都涉及临时文件的读写，因此一旦 WordPress 无法写入临时目录，就会触发相关错误。

可能的原因

1. 服务器的临时目录不可写或路径设置错误
2. wp-content 或 uploads 文件夹权限设置不当
3. PHP 的 upload_tmp_dir 参数为空或指向不存在的路径
4. 安全插件限制文件写入操作
5. 虚拟主机的隔离策略导致访问受限

解决方法

1. 检查 PHP 的临时目录设置

登录服务器，查看当前 PHP 配置：

php -i | grep upload_tmp_dir

如果没有设置或路径无效，可以编辑 php.ini 文件：

upload_tmp_dir = /tmp

修改后重启 PHP 服务。例如：

sudo systemctl restart php8.1-fpm

2. 自定义 WordPress 临时目录

在 wp-config.php 文件中添加以下内容：

define('WP_TEMP_DIR', dirname(__FILE__) . '/wp-content/temp/');

然后在 wp-content 文件夹中创建一个 temp 子目录：

mkdir wp-content/temp
chmod 755 wp-content/temp

如果仍然无法写入，可以将权限暂时设置为 775 或 777 进行测试。

3. 修正文件夹权限

确保 WordPress 所需的文件夹具备正确的权限：

chmod -R 755 wp-content
chmod -R 755 wp-content/uploads

如有必要，调整文件夹所属用户：

chown -R www-data:www-data wp-content

注意 www-data 是常见的 Web 用户，具体根据服务器环境可能不同。

4. 停用可能导致冲突的插件

一些安全插件会限制写入权限，可尝试暂时停用 Wordfence、iThemes Security 等插件进行测试。

5. 联系主机商或更换运行环境

如果上述方法都无效，问题可能出在主机限制上。可尝试联系主机服务商确认是否限制 PHP 写入权限，或考虑迁移至配置更灵活的 VPS 或云主机平台。

预防建议

• 搭建网站时，优先设置好 PHP 配置和文件权限
• 定期检查服务器目录写入状态
• 使用知名主机或官方推荐的环境，兼容性更好
• 避免频繁修改服务器默认权限或目录结构

总结

“temp-write-test” 报错通常由服务器环境引起，解决思路是检查 PHP 设置、修复文件权限、指定临时目录等。只要按照本文的方法逐项排查，大多数问题都能快速定位并修复。

如果问题持续存在，建议将报错截图与服务器信息提交至 WordPress 社区或技术论坛获取进一步帮助。

联系我们
教程看不懂？联系我们为您免费解答！免费助力个人，小企站点！	客服微信
① 电话：020-2206-9892
② QQ咨询：1025174874
③ 邮件：[email protected]
④ 工作时间：周一至周五，9:30-18:30，节假日休息