先看现象。两万张产品图的 alt 属性都是空字符串，图片搜索的流量一直是零，同一批图在竞品站上却能稳定带来几千次点击。
把日志和配置对完，能解释这个现象的基本就这几处。模板只输出了 alt=””，没有读取媒体库里的替代文本。也可能是批量导入的图片根本没有填过替代文本字段。
少数情况下是图片外层套了 figure，说明文字写在 figcaption 里，alt 仍为空。
不容易想到的是，图片搜索的落地页是附件页，旁边没有正文。
第一件事是统计页面上空 alt 的图片数量
curl -s https://www.example.com/p/1/ | grep -o 'alt="[^"]*"' | sort | uniq -c | sort -rn | head随后确认媒体库里有没有填过替代文本
wp db query "SELECT COUNT(*) FROM wp_postmeta WHERE meta_key='_wp_attachment_image_alt' AND meta_value<>'';"然后让模板回退到标题作为 alt
add_filter('wp_get_attachment_image_attributes', function($a, $id){ if (empty($a['alt'])) $a['alt'] = get_the_title($id); return $a; });复查页面上 alt 的填充率
curl -s https://www.example.com/p/1/ | grep -o 'alt=""' | wc -l改完先别撤，确认这几项。页面上空 alt 的图片数降到零，图片搜索开始有展现，GSC 的图片类展现量两周内从零涨到四位数。
容易忽略的是，alt 要写图里实际是什么，不要堆关键词，用标题兜底只是过渡，产品图最终还是要人写一遍。监控比日志更早给出信号，事后回看经常能提前半小时发现异常。