使用wp_insert_post()创建自定义文章遇返回失败但数据已入库问题排查

我来帮你排查这个典型问题：数据库里已经成功创建了wishlist自定义文章，但AJAX返回错误，而且直接返回其他数据（比如get_post）是正常的，这说明问题出在wp_insert_post执行过程中或之后，有额外输出破坏了JSON响应。

先修复代码里的明显隐患 #

你的用户ID判断逻辑有漏洞：

$user = get_user_by( 'email', $email_address );
$user_id = is_int( $user->ID ) ? $user->ID : 1;

如果get_user_by没找到对应邮箱的用户，$user会返回false，这时候访问$user->ID会触发PHP警告（比如Trying to get property 'ID' of non-object），这个警告信息会直接混入AJAX响应，和wp_send_json输出的JSON搅在一起，导致前端无法解析纯JSON，从而显示"Action failed"。

修正后的判断逻辑：

$user = get_user_by( 'email', $email_address );
$user_id = $user ? $user->ID : 1;

这样可以避免触发PHP警告，保证响应里只有纯净的JSON格式内容。

排查钩子干扰问题 #

wp_insert_post会触发一系列钩子（比如save_post、save_post_wishlist、wp_insert_post本身），如果你的主题或其他插件在这些钩子的回调函数里有echo/print输出、PHP警告/错误，或者调用了会输出内容的函数，这些内容都会破坏AJAX响应的JSON结构。

具体排查步骤：

1. 临时禁用所有其他插件，切换到WordPress默认主题（比如Twenty Twenty-Four），重新测试AJAX调用。如果恢复正常，说明是某个插件或主题的钩子导致的问题。
2. 开启WordPress调试模式查看错误日志：
   在wp-config.php中添加以下代码：

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

   触发AJAX调用后，查看wp-content/debug.log里的错误信息，定位到哪个钩子的回调有输出或错误。
3. 如果确定是某个钩子的问题，可以在wp_insert_post之前临时移除该钩子，示例：

   // 假设是save_post_wishlist钩子导致的干扰
   remove_all_actions( 'save_post_wishlist' );
   $webhook_id = wp_insert_post( $wishlist_data );
   // 若有需要，之后可重新添加该钩子
   

额外优化建议 #

• wp_send_json函数本身会自动调用wp_die()终止脚本，你最后一行的die;是多余的，可以去掉。
• 建议添加权限检查和参数存在性校验，同时用wp_kses_post清理文章内容，避免XSS风险，让代码更健壮。

修复后的完整代码示例 #

add_action( 'wp_ajax_tcf_et_create_new_estimate', 'tcf_et_create_new_estimate' );
function tcf_et_create_new_estimate() {
    // 权限检查：确保当前用户有权限创建wishlist
    if ( ! current_user_can( 'publish_posts' ) ) {
        wp_send_json_error( '无权限执行此操作' );
    }

    // 参数存在性校验
    $project_name = isset( $_REQUEST['project_name'] ) ? $_REQUEST['project_name'] : '';
    $email_address = isset( $_REQUEST['email_address'] ) ? $_REQUEST['email_address'] : '';
    $project_notes = isset( $_REQUEST['project_notes'] ) ? $_REQUEST['project_notes'] : '';

    $user = get_user_by( 'email', $email_address );
    $user_id = $user ? $user->ID : 1;

    $wishlist_data = array(
        'post_type' => 'wishlist',
        'post_title' => sanitize_text_field( $project_name ),
        'post_content' => wp_kses_post( $project_notes ), // 更安全的内容清理
        'post_status' => 'publish',
        'ping_status' => 'closed',
        'post_excerpt' => '',
        'post_author' => $user_id
    );

    $webhook_id = wp_insert_post( $wishlist_data );

    // 处理wp_insert_post可能返回的错误
    if ( is_wp_error( $webhook_id ) ) {
        wp_send_json_error( $webhook_id->get_error_message() );
    } else {
        wp_send_json( $webhook_id );
    }
}

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