WordPress中add_action钩子触发500错误的原因及修复方法

核心是两个基础逻辑没理清：

• wp_die()是WordPress封装的程序终止函数，执行后会直接中断所有后续PHP运行流程，和原生die()/exit()效果一致。
• 你把do_action('contactme')直接写在全局加载的代码里（比如主题functions.php、自定义插件主文件），意味着所有请求——不管是前台页面、后台管理、WP-Cron定时任务、REST接口——只要加载到这段代码就会立刻触发钩子，跑到wp_die()直接终止，WordPress连完整的初始化流程都走不完，自然返回500错误。

你贴的日志里的WP-Cron报错就是直接证据：定时任务请求刚执行到wp_loaded钩子阶段就被掐断，连正常响应头都发不出来，才会出现"Error getting response code"的记录。你去掉wp_die()之后代码能跑，是因为钩子执行完程序还能继续走完后续的WordPress加载流程，不会中断正常请求。

根据实际使用场景选对应方案即可：

场景1：要做自定义接口/自定义请求响应 #

不要直接在全局触发钩子，用WordPress官方提供的Ajax/Admin Post接口机制，这两个场景下回调里的wp_die()是官方要求的标准写法，不会影响其他请求：

// 同时兼容登录用户和未登录用户的请求
add_action( 'wp_ajax_contactme', 'contact' );
add_action( 'wp_ajax_nopriv_contactme', 'contact' );
function contact() {
    echo 'Success';
    wp_die(); // 此处wp_die为必需写法，用来终止后续多余输出
}

需要触发的时候直接请求/wp-admin/admin-ajax.php?action=contactme即可，不会干扰其他正常页面、定时任务的运行。

场景2：只是测试钩子是否能正常触发 #

删掉全局位置的do_action()调用，也不要在测试回调里加wp_die()，避免影响站点正常运行，可以把调试信息写到日志里查看：

add_action( 'contactme', 'contact', 10 );
function contact() {
    // 调试信息写入debug日志，不会中断程序
    error_log('contactme钩子触发成功');
    echo 'Success';
}
// 仅在需要测试的时候手动调用这行，测试完立刻注释或删除
// do_action('contactme');

• 后续调试WordPress错误先开Debug模式，在wp-config.php里加如下配置，致命错误、警告都会直接记录到日志里，比抓HTTP请求日志定位效率高很多：

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );

日志文件位置在wp-content/debug.log。

• 记一个通用原则：不要在全局代码域直接调用会终止程序的函数，包括wp_die()、die()、exit()，这类函数必须放在明确的请求判断分支、或者WordPress指定的接口回调位置，否则必然会干扰正常请求流程。

内容的提问来源于stack exchange，提问作者this_is_a_person