WordPress自定义文章类型元数据验证错误未生效问题排查

你的代码主要遗漏了这几个关键环节，导致验证失败时WordPress仍会保存文章：

1. 没中断默认保存流程 #

你只添加了错误提示，但没阻止WordPress完成保存操作。验证失败时必须主动中断流程，跳回编辑页面，否则系统会按默认逻辑保存文章。

2. 错误提示的实现不符合WordPress机制 #

• add_settings_error添加的错误需要暂存起来，因为保存后页面会跳转，跨请求的错误信息需要用set_transient临时存储。
• 你自定义的admin_notices回调里用了未定义的$errors变量，根本拿不到错误内容，自然无法显示。

3. 没排除自动保存和修订版本 #

WordPress的自动保存、修订版本都会触发save_post钩子，这些场景下不需要做验证，得先跳过。

4. 缺少权限验证 #

没检查当前用户是否有编辑该文章的权限，可能导致非法操作触发验证逻辑。

修正后的完整代码 #

add_action('save_post', function($post_id) {
    // 跳过自动保存和修订版本
    if (wp_is_post_autosave($post_id) || wp_is_post_revision($post_id)) {
        return;
    }

    // 验证用户编辑权限
    if (!current_user_can('edit_post', $post_id)) {
        return;
    }

    // 处理joLink字段
    if (isset($_POST['joLink'])) {
        $jo_link = trim($_POST['joLink']);
        if (!empty($jo_link)) {
            update_post_meta($post_id, 'joLink', $jo_link);
        } else {
            // 添加错误信息
            add_settings_error(
                'missing-link',
                'missing-link',
                '链接不能为空！',
                'error'
            );
            // 暂存错误，跳转后仍能显示
            set_transient('settings_errors', get_settings_errors(), 30);

            // 跳回编辑页面，阻止默认保存
            wp_redirect(add_query_arg(
                array(
                    'post' => $post_id,
                    'action' => 'edit',
                    'error' => 'missing-link'
                ),
                admin_url('post.php')
            ));
            exit;
        }
    } else {
        delete_post_meta($post_id, 'joLink');
    }
});

// 显示错误提示
add_action('admin_notices', function() {
    $errors = get_transient('settings_errors');
    if ($errors) {
        // 用WordPress内置函数显示错误
        settings_errors('missing-link');
        // 删除暂存的错误，避免重复显示
        delete_transient('settings_errors');
    }
});

修正关键点说明 #

• 先过滤掉自动保存和修订版本，避免干扰正常编辑流程。
• 增加权限校验，确保操作合法。
• 验证失败时用wp_redirect跳回编辑页面，并用set_transient暂存错误，保证跳转后能看到提示。
• 用settings_errors()统一渲染错误，符合WordPress的后台UI规范，不用手动拼HTML。
• 跳转后删除暂存的错误，防止下次打开页面重复显示提示。

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