WordPress中save_post钩子保存自定义文章类型时不触发问题

基础配置问题排查 #

• 修正日志路径错误：你当前测试代码使用相对路径test.log写入日志，不同保存场景（原生文章后台保存、自定义文章类型AJAX/REST保存）的PHP工作目录不一致，会导致日志被写入你未查看的其他目录，必须使用WP内置绝对路径常量指定日志位置，避免误判钩子未触发。
• 调整钩子注册参数：默认save_post钩子注册时未指定优先级和接受参数数量，若其他插件/主题用高优先级提前终止保存流程，你的回调会被跳过。测试时请将优先级设为99，声明接受3个传入参数，同时排除自动保存、修订版本、自动草稿的无效触发：

function test123($post_id, $post, $update){
    // 跳过非有效内容的保存触发
    if (wp_is_post_autosave($post_id) || wp_is_post_revision($post_id) || get_post_status($post_id) === 'auto-draft') {
        return;
    }
    // 用绝对路径写入日志，同时记录当前文章类型确认命中范围
    file_put_contents(ABSPATH . 'test.log', '钩子触发，文章类型：' . $post->post_type . '，文章ID：' . $post_id . "\n", FILE_APPEND);
}
add_action('save_post', 'test123', 99, 3);

• 排除钩子注册范围限制：如果你将钩子注册代码写在is_admin()判断分支内，自定义文章类型走REST接口保存（古腾堡编辑器默认保存逻辑）时不会触发完整后台初始化流程，钩子不会被注册，需将add_action代码放到全局加载范围，不要加后台判断限制。

Toolset专属逻辑适配 #

• Toolset Types插件在保存自定义文章类型时，部分场景（自定义字段批量保存、前端表单提交、关联关系同步）不会完整走原生WP文章保存流程，会跳过save_post/wp_after_insert_post钩子，需使用Toolset官方提供的专属钩子做回调绑定：
  • 自定义文章类型主数据保存完成后触发：使用toolset_post_type_saved钩子，接受$post_id、$post_type、$post_object三个参数
  • 自定义字段数据保存完成后触发：使用toolset_post_field_saved钩子
• 对应测试代码示例：

function toolset_cpt_save_callback($post_id, $post_type, $post) {
    // 替换为你自己的自定义文章类型slug
    if ($post_type !== 'your_custom_cpt_slug') {
        return;
    }
    file_put_contents(ABSPATH . 'test.log', 'Toolset自定义文章保存触发，ID：' . $post_id . "\n", FILE_APPEND);
}
add_action('toolset_post_type_saved', 'toolset_cpt_save_callback', 10, 3);

冲突排查 #

• 临时切换为WordPress默认主题（如Twenty Twenty-Four），禁用除Toolset Types外的所有插件，再测试钩子触发情况。如果此时钩子正常触发，说明存在主题/插件冲突，可逐个开启功能定位到提前移除钩子、终止保存流程的冲突代码。

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