Beyond‘s blog博客

2025.09.02 IT/Web技术

【中国服务器】YouTube 视频的缩略图无法显示

在中国服务器环境下运行WordPress时，仅在文章中粘贴YouTube视频URL，大多数情况下无法自动显示缩略图。

在正常的WordPress环境中，只需粘贴YouTube等主要视频平台的URL，oEmbed功能就会生效，自动生成带缩略图的嵌入播放器。

然而，在中国服务器上，这种自动嵌入功能很多时候无法正常工作。

这是由于中国特有的网络法规及技术限制所致，处理视频内容时需要采取特殊应对措施。

本文将为您解说WordPress中嵌入视频的方法、中国服务器特有的限制，以及相应回避策略。

1 在WordPress中嵌入视频的两种方法
- 1.1 参考：WordPress自动嵌入支持的主要平台
2 中国服务器注意事项：YouTube自动嵌入无法正常工作的原因
- 2.1 主要技术因素
3 技术上的回避方案（临时措施）
4 总结
- 4.1 相关服务

在WordPress中嵌入视频的两种方法

在WordPress环境的文章页面中插入视频的方法，大致有以下两种。

项目	优点	缺点
① 直接上传到本地服务器	○ 不依赖外部服务 ○ 可完全控制 ○ 适用于非公开或限制访问的网站	○ 消耗服务器容量和带宽 ○ 可能导致网站显示速度下降
② 嵌入外部平台（如YouTube）的URL	○ 节省服务器资源 ○ 可期待流畅播放 ○ 具有社交网络扩散效果	○ 依赖外部服务 ○ 在中国服务器环境下很多时候无法正常工作

参考：WordPress自动嵌入支持的主要平台

以下是WordPress（基于Gutenberg编辑器）自动嵌入支持的主要平台。

在通常环境（非中国服务器）下，只需粘贴URL即可实现自动嵌入功能。

* 但是，在中国服务器环境下，尤其是YouTube会出现缩略图不显示等问题，即本文要讨论的问题。

项目	主要平台
非中国服务器的WordPress环境（基于Gutenberg编辑器）	Amazon、Animoto、Cloudup、CollegeHumor、Crowdsignal、Dailymotion、Facebook、Flickr、Hulu、Imgur、Instagram、Issuu、Kickstarter、Meetup.com、Mixcloud、Reddit、ReverbNation、Screencast、Scribd、Slideshare、SmugMug、Someecards、SoundCloud、Speaker Deck、Spotify、TED、Tumblr、VideoPress、Vimeo、WordPress.tv、X（原Twitter）、YouTube

中国服务器注意事项：YouTube自动嵌入无法正常工作的原因

< 在中国服务器上不显示缩略图 >

本文以使用频率较高的YouTube为例，详细说明问题。

通常情况下，WordPress在可视化编辑器中粘贴YouTube链接后，会在内部使用oEmbed API从YouTube获取元信息（缩略图、视频标题等）。

其结果是，会自动转换为iframe格式，并在文章中显示带缩略图的播放器。

但是，在中国服务器环境下，这一系列流程无法正常工作，会出现“不显示缩略图”、“无法播放视频”等问题。

主要技术因素

项目	概要
对YouTube资源的访问被阻断	缩略图URL（例如：https://img.youtube.com/vi/VIDEO_ID/hqdefault.jpg）或oEmbed端点（https://www.youtube.com/oembed）的访问被阻断。因此，WordPress无法获取元数据，无法生成缩略图。
防火墙丢弃请求	从中国服务器发出的对YouTube的请求（尤其是获取缩略图）在中途被丢弃。结果，只显示空的占位符，而不显示图像。
WordPress的oEmbed缓存问题	在通常的WordPress环境下，会缓存一次获取到的oEmbed数据。但是，在中国服务器环境下，首次请求失败，因此无法创建缓存，之后缩略图也一直为空。

技术上的回避方案（临时措施）

< 在中国服务器上需手动编写iframe代码 >

要避免这些问题，可以不依赖自动嵌入，采用手动编写iframe代码的方法。

具体来说，在文章文本编辑器（或自定义HTML区块）中，直接编写如下所示的iframe标签。

<iframe width="560" height="315" src="https://www.youtube.com/embed/VIDEO_ID" frameborder="0" allowfullscreen></iframe>
* 但是，即使使用此方法嵌入，视频播放本身在中国国内访问时仍会被屏蔽。