Django模板嵌入Youtube URL至Frame遇X-Frame-Options错误求助

问题根源 #

你遇到的报错Refused to display 'https://www.youtube.com/' in a frame because it set 'X-Frame-Options' to 'sameorigin'，和你的Django项目配置无关——这个限制是YouTube服务器自身设置的，它禁止直接在iframe中嵌入普通的YouTube观看页面。你修改自己项目的X_FRAME_OPTIONS、添加装饰器、移除中间件都是无效操作，因为这些设置是控制你的页面能否被别人嵌入，而非你嵌入外部页面的权限。

正确解决方法 #

必须使用YouTube官方提供的嵌入专用链接格式，替换普通的视频观看链接：

• 普通视频链接格式：https://www.youtube.com/watch?v=视频ID
• 嵌入专用链接格式：https://www.youtube.com/embed/视频ID

模板中直接修改示例

把原来的iframe代码：

<iframe src="https://www.youtube.com/watch?v=abc123"></iframe>

改为：

<iframe src="https://www.youtube.com/embed/abc123" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>

批量/动态转换链接（视图层处理）

如果视频链接是从数据库或后端动态获取的，可以在Django视图中统一转换为嵌入格式：

import re

def your_view(request):
    # 假设从数据库获取的原始YouTube链接
    original_youtube_url = "https://www.youtube.com/watch?v=abc123"
    # 正则提取视频ID（YouTube视频ID固定为11位）
    video_id_match = re.search(r'(?:v=|\/)([0-9A-Za-z_-]{11}).*', original_youtube_url)
    video_id = video_id_match.group(1) if video_id_match else None
    # 拼接成嵌入链接
    embed_url = f"https://www.youtube.com/embed/{video_id}" if video_id else ""
    return render(request, 'your_template.html', {'embed_url': embed_url})

然后在模板中引用：

<iframe src="{{ embed_url }}" frameborder="0" allowfullscreen></iframe>

额外说明 #

• 对于播放列表，嵌入格式为https://www.youtube.com/embed/videoseries?list=播放列表ID
• 确保使用YouTube官方的嵌入规范，避免后续因为规则变动再次出现问题

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