在 WordPress 中使用 wp_get_recent_posts() 查询自定义文章类型（CPT）时，若 ACF 字段（如 the_field()）返回空值，通常是因为该函数默认返回关联数组而非对象，导致 $photo->ID 访问失败。
在 wordpress 中使用 `wp_get_recent_posts()` 查询自定义文章类型（cpt）时，若 acf 字段（如 `the_field()`）返回空值，通常是因为该函数默认返回关联数组而非对象，导致 `$photo->id` 访问失败。
WordPress 的 wp_get_recent_posts() 函数默认返回一个关联数组（associative array），而非 WP_Post 对象。这意味着当你遍历 $recent_photos 时，每个 $photo 实际是形如 ['ID' => 123, 'post_title' => '...'] 的数组，而非可直接用 -> 访问属性的对象。因此，$photo->ID 会返回 null 或触发 PHP 警告，进而导致 ACF 函数（如 the_field('client', $photo->ID)）因传入无效 ID 而静默失败。
✅ 正确解决方案（任选其一）
方案一：显式指定返回类型为 object
在调用 wp_get_recent_posts() 时，传入第二个参数 OBJECT（或字符串 'object'），强制返回 WP_Post 对象数组：
$recent_photos = wp_get_recent_posts(
array(
'numberposts' => 8,
'post_type' => 'fotos',
'post_status' => 'publish',
),
OBJECT // ← 关键：指定返回对象
);
if ($recent_photos) {
foreach ($recent_photos as $photo) {
echo '<div class="item-grid--item">';
the_field('client', $photo->ID); // ✅ 现在 $photo 是对象，$photo->ID 有效
echo '</div>';
}
}
? 注意：numberposts 参数应使用整数 8 而非字符串 '8'，虽字符串常被自动转换，但整数更规范、避免潜在类型问题。
方案二：保持默认数组行为，改用数组语法访问键
若不修改函数调用，需将 $photo->ID 改为 $photo['ID']：
$recent_photos = wp_get_recent_posts(array(
'numberposts' => 8,
'post_type' => 'fotos',
'post_status' => 'publish',
));
if ($recent_photos) {
foreach ($recent_photos as $photo) {
echo '<div class="item-grid--item">';
the_field('client', $photo['ID']); // ✅ 使用方括号访问数组键
echo '</div>';
}
}
⚠️ 其他关键注意事项
- ACF 字段名与位置匹配：确保字段 client 已在 ACF 后台正确分配给 fotos 自定义文章类型（而非“页面”或“文章”），且发布状态为启用。
- 避免在主循环中嵌套查询：你当前代码将 wp_get_recent_posts() 放在 while (have_posts()) 主循环内，会导致每次主循环迭代都重复执行一次数据库查询（即使首页仅显示一次照片墙）。建议将其移出主循环，或改用更高效的 WP_Query 并复用 $post 全局变量（如需展示当前 CPT 文章的 ACF 值）。
- 调试技巧：临时添加 var_dump($photo); die(); 可直观确认 $photo 结构；用 get_field('client', $photo_id) 替代 the_field() 可避免输出干扰，便于调试返回值。
通过修正数据结构访问方式，并结合规范的参数类型与合理的位置配置，即可稳定输出 ACF 字段内容。
