wp_insert_post创建calendar自定义文章后无法被查询的问题

代码创建的calendar自定义文章后台可见但前端查询不到，手动更新后恢复正常，核心原因大概率是缓存未同步或ACF字段未正确写入，以下是针对性解决方法：

1. 创建文章后强制清理缓存 #

WordPress默认会缓存帖子数据，wp_insert_post执行后缓存可能未及时更新，导致前端查询无法获取新帖子。在创建代码末尾添加缓存清理逻辑：

$ID = wp_insert_post($post_args);
if ($ID && !is_wp_error($ID)) {
    // 清理单篇文章缓存
    clean_post_cache($ID);
    // 清理全局帖子缓存
    wp_cache_delete($ID, 'posts');
}

2. 用ACF官方函数同步自定义字段 #

如果client和status是ACF字段，直接调用wp_insert_post不会自动同步ACF的元数据，必须使用ACF官方函数update_field写入（不要用update_post_meta，避免ACF内部数据不同步）：

$ID = wp_insert_post($post_args);
if ($ID && !is_wp_error($ID)) {
    // 替换为实际的字段值
    update_field('client', $clienteId, $ID);
    update_field('status', 'producao', $ID); // 匹配你的状态值
    clean_post_cache($ID);
}

3. 检查自定义文章类型注册参数 #

确认register_post_type注册calendar时，关键参数配置正确（否则前端会被过滤查询）：

register_post_type('calendar', array(
    'public' => true,
    'publicly_queryable' => true,
    'exclude_from_search' => false,
    'query_var' => true,
    // 其他参数...
));

4. 逐步排查WP_Query参数 #

• 先简化查询：去掉meta_query，只保留post_type='calendar'和post_status='publish'，验证是否能获取新创建的帖子，排除字段匹配问题。
• 确认client字段值与$clienteId类型完全一致（比如数字/字符串是否匹配）。
• 确认status字段值确实在查询的array('producao', 'aguardando', 'ajuste', 'reprovado')范围内。

内容的提问来源于stack exchange，提问作者Lucas M. Falbo