本文详解如何在wordpress自定义维护模式中，安全、可靠地排除特定页面（如注册页、调查页）免受维护拦截，解决is_page()在早期钩子中不可用的问题，并提供可直接部署的优化代码。
本文详解如何在wordpress自定义维护模式中，安全、可靠地排除特定页面（如注册页、调查页）免受维护拦截，解决is_page()在早期钩子中不可用的问题，并提供可直接部署的优化代码。
在WordPress中启用全局维护模式时，常需保留关键前端页面（如登录页、邮件订阅页、用户调研页）的可访问性，否则会阻断用户转化路径或管理员调试入口。原始插件逻辑仅通过 $pagenow !== 'wp-login.php' 排除后台登录页，但 is_page() 等模板条件函数依赖于主查询（WP_Query）初始化完成，而 wp_loaded 钩子虽已加载核心，却尚未执行 wp 钩子（即主查询未建立），因此在该阶段直接调用 is_page('survey') 始终返回 false —— 这正是你尝试失败的根本原因。
✅ 正确解法是：延迟维护逻辑至 template_redirect 钩子，此时主查询已就绪，所有条件标签（is_page()、is_home()、is_singular()等）均可安全使用；同时保留管理员与登录页豁免逻辑，形成多层白名单机制。
以下是优化后的完整代码（推荐替换原插件中的 ng_maintenance_mode 函数及钩子）：
function ng_maintenance_mode() {
// 1. 管理员始终绕过维护模式
if ( current_user_can( 'manage_options' ) ) {
return;
}
// 2. 后台请求（admin-ajax.php、wp-login.php等）不拦截
global $pagenow;
if ( is_admin() || $pagenow === 'wp-login.php' || $pagenow === 'admin-ajax.php' ) {
return;
}
// 3. 关键前端页面白名单（支持页面ID、slug、标题、数组）
// ✅ 此处 is_page() 已可用
$whitelist_pages = array(
'survey', // 页面slug（如 https://yoursite.com/survey/）
'opt-in', // 另一页面slug
123, // 或直接使用页面ID
'Thank You' // 或页面标题（不推荐，易受翻译影响）
);
if ( is_page( $whitelist_pages ) ) {
return;
}
// 4. 触发503状态码并渲染维护页
status_header(503);
header('Content-Type: text/html; charset=utf-8');
$maintenance_file = plugin_dir_path(__FILE__) . 'views/maintenance.php';
if (file_exists($maintenance_file)) {
require_once $maintenance_file;
} else {
wp_die('Site is under maintenance.', 'Maintenance Mode', array('response' => 503));
}
exit;
}
add_action('template_redirect', 'ng_maintenance_mode');
? 关键注意事项：
- 勿用 wp_loaded + is_page()：该组合必然失效，因主查询未初始化；
- 优先使用 slug 或 ID 白名单：比页面标题更稳定，避免多语言或编辑后失效；
- 显式调用 exit 或 die()：防止后续钩子继续执行导致页面重复输出；
- status_header(503) 更规范：替代手动拼接协议头，兼容不同服务器环境；
- 检查文件存在性：避免维护页缺失时产生PHP警告；
- 如需动态管理白名单（如通过设置页面配置），可将 $whitelist_pages 替换为 get_option('maintenance_whitelist', array())。
通过此方案，你的调查页（/survey/）及其他指定页面将完全绕过维护拦截，普通用户仍可正常访问，而其余页面则统一显示维护提示——兼顾用户体验与站点管控需求。
