设置了特色图片 前台文章页还是不显示

wp post meta get 318 _thumbnail_id
wp media get 902 --field=file
wp post meta list 318 --keys=_thumbnail_id

后台右侧特色图片位置明明有缩略图，前台文章页顶部却是空的。换一张图也一样，检查元素里连 img 标签都没有。这类现象通常不是突然出现的，往前翻半天日志能看到苗头。

追下去是这么回事：主题没有对当前文章类型声明 post-thumbnails 支持，模板里的 the_post_thumbnail 直接返回空。另一种情况是 _thumbnail_id 指向的附件已经被删，函数拿不到可用的图片地址。

围绕「特色图片不显示」排查时，命令行跑一遍比在面板里点十次有用，面板会替你做掉不少隐式操作。监控和日志的时间要对上，时区不一致会多绕很大一圈。

临时改动用注释写上日期和原因，过两周自己都记不清为什么这么写。

处理上按这个顺序：先在模板里确认调用了 the_post_thumbnail，且没有条件判断把它挡掉；检查主题是否 add_theme_support('post-thumbnails')，自定义文章类型要单独声明；核对 _thumbnail_id 对应的附件文件还在不在，不在就重新设置一次。

确认没问题再收工，文章页顶部出现特色图片，源码里 img 的 src 指向 uploads 下的真实文件。