我之前开发WordPress自定义AJAX端点时也碰到过一模一样的糟心事！WordPress对admin-ajax.php的错误处理逻辑和普通页面完全不同——默认会把所有语法、逻辑、致命错误都吞掉，只返回干巴巴的"500 Internal Server Error"，调试时只能蹲在服务器日志里翻找线索，效率极低。下面分享几个实用的解决办法：

方法1：临时开启admin-ajax.php的前端错误输出 #

这是最直接的调试方式，适合快速定位问题。你可以在/wp/wp-admin/admin-ajax.php文件的末尾（wp_die();语句之前）添加以下代码：

// 临时开启错误输出，调试完成后务必删除！
ini_set('display_errors', 1);
ini_set('display_startup_errors', 1);
error_reporting(E_ALL);

添加后，当你的自定义action触发错误时，浏览器就能直接看到具体的PHP报错信息（包括错误类型、行号、文件路径），不用再去翻服务器日志。重要提醒：调试完成后一定要删除这段代码，避免泄露服务器敏感信息！

方法2：给自定义AJAX处理函数添加错误捕获 #

更安全且可持续的方式，是在你自己的AJAX业务代码里手动捕获错误，把详细信息返回给前端：

add_action('wp_ajax_some_action', 'handle_some_action');
add_action('wp_ajax_nopriv_some_action', 'handle_some_action');

function handle_some_action() {
    try {
        // 这里写你的AJAX业务逻辑代码
        // 比如：数据查询、处理、返回等操作
        // ...
        
        wp_send_json_success(['result' => '处理完成']);
    } catch (Throwable $e) {
        // 捕获所有错误并返回详细信息
        wp_send_json_error([
            'error_msg' => $e->getMessage(),
            'error_line' => $e->getLine(),
            'error_file' => $e->getFile()
        ]);
    }
    wp_die();
}

这种方式不会影响全局的admin-ajax.php逻辑，调试完成后也不需要额外清理代码，还能精准控制返回的错误内容。

方法3：增强WordPress调试日志的详细程度 #

如果不想修改代码，也可以通过调整wp-config.php的配置，让调试日志更清晰：

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

虽然admin-ajax.php还是不会在前端显示错误，但wp-content/debug.log文件里会记录完整的报错栈信息，比服务器自带的PHP日志更贴合WordPress的运行场景，排查问题时也更高效。

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