只在后台禁用Heartbeat：不影响前台与编辑体验

在 WordPress 的性能优化实践中，Heartbeat API 是一个绕不开却经常被“误伤”的模块。
很多站点在优化后台性能时，直接全站禁用 Heartbeat，结果带来：

编辑器自动保存失效
多人协作锁定异常
WooCommerce 订单状态不同步
后台体验反而变差

正确的做法不是“关掉 Heartbeat”，而是：只在后台的非编辑场景中禁用它。

本文将完整讲清楚：

Heartbeat 到底在做什么
为什么“只在后台禁用”是最优解
多种安全、可控的实现方式
不同后台页面的差异化策略
常见踩坑与验证方法

一、Heartbeat 是什么？为什么它会拖慢后台

1. Heartbeat 的本质

Heartbeat API 是 WordPress 后台的一套 定时 AJAX 轮询机制，默认：

每 15–60 秒 触发一次
通过 admin-ajax.php 或 REST API
持续与服务器交换状态数据

主要用途包括：

文章自动保存
编辑锁（防止多人覆盖）
后台通知、状态刷新
WooCommerce 订单/库存实时更新

2. 问题出在哪里

在真实生产环境中，Heartbeat 的问题并不在“功能”，而在于频率 + 范围：

后台每个打开的页面都在轮询
多个管理员同时在线时请求叠加
低配服务器 / 海外服务器 RTT 高
admin-ajax.php 本身性能较差

最终表现为：

后台 CPU 占用偏高
MySQL 查询数异常
PHP-FPM 进程堆积
后台偶发卡顿、转圈

二、为什么不能“全局禁用 Heartbeat”

很多教程会建议：

add_action( 'init', function() {
    wp_deregister_script( 'heartbeat' );
});

这是错误示范。

原因很简单：

功能	是否依赖 Heartbeat
Gutenberg 自动保存	✅
编辑锁（Editing Lock）	✅
WooCommerce 后台订单刷新	✅
经典编辑器草稿保护	✅

一刀切的后果通常是：

编辑内容丢失
多人编辑冲突
后台功能“看似正常，实际暗雷”

所以目标必须是：

只在【后台非编辑页面】禁用 Heartbeat
保留编辑器、关键功能所需的心跳

三、最佳策略总览（先给结论）

一个成熟、可控的策略应满足：

✅ 不影响前台（Front-end）
✅ 不影响文章/页面编辑
✅ 仅作用于 wp-admin
✅ 可扩展、可维护

推荐优先级：

基于 admin_enqueue_scripts 精准禁用（首选）
基于页面判断条件差异化处理
控制 Heartbeat 频率（非完全禁用）
插件方案（仅作为补充）

四、方案一（推荐）：只在后台非编辑页面禁用 Heartbeat

核心思路

Heartbeat 是一个脚本：heartbeat
后台加载时，通过钩子有条件移除
编辑页（post.php / post-new.php）不动
其它后台页面直接禁用

完整可用代码

/**
 * Disable Heartbeat only on admin non-editor pages
 */
add_action( 'admin_enqueue_scripts', function() {

    // 当前后台页面
    $screen = get_current_screen();

    if ( ! $screen ) {
        return;
    }

    // 编辑文章 / 页面时，保留 Heartbeat
    if ( $screen->base === 'post' ) {
        return;
    }

    // 其余后台页面禁用 Heartbeat
    wp_deregister_script( 'heartbeat' );
});

这个方案为什么安全

admin_enqueue_scripts 只在后台生效
post 页面明确排除（编辑体验不受影响）
不触碰前台脚本
不影响 REST API

五、方案二：更精细的后台页面控制（进阶）

如果你是大型站点 / 电商后台 / 多角色系统，可以更精细。

示例：只在这些页面保留 Heartbeat

文章 / 页面编辑
WooCommerce 订单页
自定义后台仪表盘

add_action( 'admin_enqueue_scripts', function() {

    $screen = get_current_screen();
    if ( ! $screen ) return;

    $allowed = [
        'post',
        'woocommerce_page_wc-orders',
    ];

    if ( in_array( $screen->base, $allowed, true ) ) {
        return;
    }

    wp_deregister_script( 'heartbeat' );
});

适合：

WooCommerce 独立站
多人后台操作
高频订单 / 内容更新系统

六、方案三：不禁用，只“降频”（更保守）

如果你担心完全禁用带来未知影响，可以降低 Heartbeat 频率。

示例：后台非编辑页面 → 120 秒一次

add_filter( 'heartbeat_settings', function( $settings ) {

    if ( is_admin() ) {
        $settings['interval'] = 120;
    }

    return $settings;
});

对比说明

策略	服务器压力	功能完整性
完全禁用	⭐⭐⭐⭐	⭐⭐
仅后台禁用	⭐⭐⭐⭐	⭐⭐⭐⭐
降频	⭐⭐⭐	⭐⭐⭐⭐⭐

七、插件方案（不推荐作为长期方案）

常见插件：

Heartbeat Control
WP Rocket（附带）

问题在于：

粒度不够细
升级后行为不可控
难以区分具体后台页面

适合：

不方便写代码
临时测试
小型站点

不适合：

高并发
电商
多编辑者系统

八、常见踩坑与排查清单

1. 编辑器自动保存失效

原因：误禁用 post 页面
解决：确认 $screen->base === 'post' 被排除

2. WooCommerce 订单不刷新

原因：订单页依赖 Heartbeat
解决：加入白名单

3. 前台被误伤

原因：使用了 init / wp_enqueue_scripts
解决：只用 admin_enqueue_scripts

4. 判断条件失效

原因：get_current_screen() 过早调用
解决：不要用在 init 钩子

九、如何验证是否真的生效

方法一：浏览器 Network 面板

打开后台非编辑页
过滤 heartbeat / admin-ajax.php
不再出现周期性请求 ✅

方法二：服务器日志

admin-ajax.php 请求数明显下降
PHP-FPM 负载下降

十、总结（直接给结论）

正确的 Heartbeat 优化原则只有一句话：

不要关掉你需要的功能，只关掉你不需要的场景。

最佳实践：

✅ 前台不动
✅ 编辑页不动
✅ 后台非编辑页禁用
✅ 代码级控制，避免插件依赖

如果你愿意，下一步我可以帮你：

按 WooCommerce / 内容站 / SaaS 后台 给你定制版本
帮你把这篇整理成 SEO 技术博客结构（H1-H4 + Meta）
或直接给你一个 可复用的 mu-plugin 版本

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