突发故障：移动端App嵌入YouTube视频加载失败求助

1. 核查YouTube API配额与权限 #

• 登录Google Cloud控制台，查看对应API项目的YouTube Data API v3（或嵌入相关API）配额使用情况，确认2小时前是否触发了当日限额。
• 检查API密钥的权限配置：是否误删了https://www.googleapis.com/auth/youtube.embed相关权限，或者密钥新增了IP/应用包名限制，而移动端包名/签名未在允许列表内。

2. 排查WebView配置异常 #

• 确认App内WebView的javascriptEnabled是否被意外关闭（YouTube嵌入依赖JS运行），或者是否新增了内容安全策略（CSP），拦截了youtube.com、googlevideo.com的资源加载。
• 验证WebView的User-Agent：部分YouTube嵌入逻辑会依据UA识别设备，若移动端WebView的UA被修改为非移动标识，可能导致加载失败，可临时替换为标准移动端UA测试。

3. 检查嵌入代码/SDK版本 #

• 若使用YouTube Android Player SDK，确认版本是否过旧——YouTube会淘汰旧版API，尝试升级到最新稳定版后重新打包测试。
• 若是iframe嵌入，对比网页端正常的iframe代码，检查移动端嵌入的src是否遗漏embed/路径，或参数（如rel=0、autoplay=1）违反了YouTube最新嵌入规则。

4. 验证网络与地区限制 #

• 在移动端设备直接访问https://www.youtube.com/embed/[视频ID]，测试是否能正常加载。若无法访问，可能是运营商临时屏蔽了嵌入域名，或设备VPN/代理设置冲突。
• 检查App是否在2小时前新增了地区过滤逻辑，导致移动端用户受限制但网页端未受影响。

5. 清理缓存与本地配置 #

• 清空App的本地缓存和WebView缓存，重启App测试——移动端WebView可能缓存了过期资源或错误状态。
• 检查本地存储的API密钥/配置是否过期，若有本地存储的API相关信息，确认是否在2小时前到期导致请求失败。

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