为什么 WordPress 小版本自动升级失效?

教程笔记 wes 45 minutes ago (2026-11-19) 5 views
📑 本文导航

 

同样设置define( ‘WP_AUTO_UPDATE_CORE’, ‘minor’ ); 香港vps可以自动更新WP到最新小版本,国内为什么不行?

核心

WP_AUTO_UPDATE_CORE='minor' 这个常量本身阿里云和香港 VPS 生效规则完全一样,国内不行,90% 是服务器出站连不上 api.wordpress.org / downloads.wordpress.org,香港 VPS 不受这个网络限制,所以自动更新正常。

这个常量只是控制 “要不要自动更小版本”,不能解决网络不通、权限、cron 被禁用的问题WordPress …

一、先在服务器上验证连通性(SSH 执行)

# 测试api.wordpress.org
curl -v https://api.wordpress.org
# 测试下载源
curl -v https://downloads.wordpress.org
  • 超时、连接失败、cURL error 7/28:就是国内阿里云公网直接访问 WordPress 官方源不通(最常见)
  • 能正常返回内容:网络没问题,往下查权限、cron、其他常量

安全组默认不拦出站 443,但国内公网环境对这两个国外域名有连通问题,不是安全组入方向的事。

二、第二大类:文件权限 & 属主

WP 自动更新不需要 FTP 弹窗的前提:网站文件属主 = php-fpm 运行用户(www/www-data)

  1. 目录:755,文件:644
  2. 重点目录:wp-content/upgrade 必须存在、可写
  3. 如果文件是 root 上传,php 进程没有写入权限 → 自动更新直接静默失败,后台不会报错

宝塔示例修复:

chown -R www:www /网站目录
find /网站目录 -type d -exec chmod 755 {} \;
find /网站目录 -type f -exec chmod 644 {} \;


常见目录:
chmod 755 /var/www/wordpress/wp-content/upgrade
chmod 644 /var/www/wordpress/wp-content/upgrade

三、第三:WP Cron 被禁用(自动更新靠 wp-cron 触发)

自动更新是 WP 后台定时任务跑的,不是系统 crontab:

  1. 检查有没有写这个:
define('DISABLE_WP_CRON', true);

有这条,WP 内置定时直接停掉,自动更新永远不会跑,删掉它。 2. 如果是高并发站点,用 ALTERNATE_WP_CRON 或者系统 crontab 替代 wp-cron,否则定时任务不触发。

四、第四:冲突常量(优先级高于 minor)

检查 wp-config.php、主题 functions、插件 snippet 里有没有:

define('AUTOMATIC_UPDATER_DISABLED', true); // 全局关闭所有自动更新,优先级最高
define('DISALLOW_FILE_MODS', true); // 禁止任何文件修改,更新直接失效

只要存在任意一条,哪怕你写了 minor,也不会自动更新WordPress …

五、第五:插件 / 主题过滤、版本控制标记

  • 很多安全插件、维护插件、WP Rocket、UpdraftPlus 自带关闭自动更新开关
  • 如果目录里有 .git,WP 会识别为版本控制,自动禁用后台自动更新(官方特性)WordPress …

六、国内服务器可行方案(网络不通的解决)

方案 A(推荐,国内镜像源)

使用 WP China Yes 插件,自动替换 api.wordpress.org、downloads 为国内镜像,不需要代理,国内服务器稳定自动更新。

方案 B(出站代理)

给 PHP 出站配置代理,或者用 Cloudflare Workers 做域名代理,在 wp-config 增加代理配置:

define( 'WP_PROXY_HOST', '你的代理地址' );
define( 'WP_PROXY_PORT', 1080 );

方案 C(替代方案,WP-CLI 系统定时)

放弃 WP 原生自动更新,用系统 crontab + wp-cli 定时执行小版本更新,不受 WP 网络限制:

# 示例,每天凌晨检查小版本更新
0 1 * * * cd /网站目录 && wp core update --minor

七、快速排查顺序

  1. SSH curl 测试能不能连上 api.wordpress.org(判断是不是网络问题)
  2. 检查 wp-config 是否有 DISABLE_WP_CRON / AUTOMATIC_UPDATER_DISABLED / DISALLOW_FILE_MODS
  3. 检查文件属主、权限、wp-content/upgrade 目录
  4. 后台【工具 → 站点健康】,看 “后台计划任务”、“与WordPress.org通信” 项目报错
  5. 排查安全插件、缓存插件、git 版本目录

补充:WP_AUTO_UPDATE_CORE='minor' 本身就是默认行为,你不加这行,正常站点本来就是只自动更小版本;你加这行只是显式声明


↑