WordPress中ACF字段更新后无法正常渲染问题求助

可能原因及对应解决方法 #

1. ACF字段值类型不统一导致Twig判断失效 #

ACF的真假复选框新建时可能存储为整数1/0，但修改后可能变为字符串'1'/'0'。Twig的{% if %}判断对类型严格，字符串'0'会被判定为真值，导致逻辑错误。

解决方法：

• Twig层显式转换为布尔判断：

{% set coworker = item.meta('coworker') is same as(1) %}

或者使用类型转换：

{% set coworker = item.meta('coworker')|int == 1 %}

• PHP层统一处理字段值：

$context['coworkers'] = array_map(function($post) {
    $post->is_coworker = (bool) get_field('coworker', $post->ID);
    return $post;
}, Timber::get_posts(['post_type' => 'coworker']));

之后Twig直接使用处理后的字段：

{% if item.is_coworker %}

2. Timber的Meta缓存未更新 #

Timber会缓存文章的元数据，修改ACF字段后缓存可能未及时刷新，导致读取旧值。

解决方法：

• 添加ACF保存钩子清除对应文章的缓存：

add_action('acf/save_post', function($post_id) {
    if (get_post_type($post_id) === 'coworker') {
        $post = Timber::get_post($post_id);
        $post->clear_meta_cache();
    }
});

• 调试时临时禁用Meta缓存（不推荐生产环境）：

add_filter('timber/post/meta/cache', '__return_false');

3. 字段名与自定义文章类型名冲突 #

自定义文章类型为coworker，ACF字段名也为coworker，可能导致Timber解析元数据时出现混淆。

解决方法：修改ACF字段名为is_coworker，同步更新模板调用：

{% set coworker = item.meta('is_coworker') %}

调试技巧 #

在Twig中输出字段原始值和类型，快速定位问题：

{{ item.meta('coworker') }} - 类型：{{ item.meta('coworker')|type }}

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