iOS嵌入YouTube视频触发Error code:152-4（视频不可用）问题的解决办法咨询
2026-4-13
iOS嵌入YouTube视频触发Error code:152-4（视频不可用）问题的解决办法咨询
你好呀，针对你碰到的iOS嵌入YouTube视频出现Error code:152-4的问题，我来帮你梳理下可能的原因和对应的解决办法：
先搞懂Error 152-4是什么
这个错误一般是YouTube的嵌入验证失败导致的，常见原因要么是视频本身不允许被嵌入，要么是我们的WebView请求方式不符合YouTube的嵌入规则。
具体排查&修复步骤
1. 优先检查目标视频的嵌入权限
这是最常见的原因！你需要登录YouTube Studio，找到你要嵌入的视频：
- 进入「内容」页面，选中对应视频
- 打开「权限」标签页，找到「嵌入设置」
- 确认「允许嵌入视频」这个选项是开启状态，如果没开，打开之后再测试看看。
2. 优化现有代码的iframe请求参数
你的WebView配置整体是对的，但可以给iframe的URL加上显式的origin参数，帮YouTube更准确地验证请求来源，避免误判。调整后的loadPlayer方法代码如下：
private func loadPlayer() { let html = """ <!DOCTYPE html> <html> <head> <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no"> <style> html, body { margin: 0; padding: 0; background: #000; width: 100%; height: 100%; overflow: hidden; } iframe { position: absolute; top: 0; left: 0; width: 100%; height: 100%; border: none; } </style> </head> <body> <!-- 新增origin=https://www.youtube.com参数，明确请求来源 --> <iframe src="https://www.youtube.com/embed/\(youtubeId)?playsinline=1&rel=0&modestbranding=1&autoplay=0&controls=1&origin=https://www.youtube.com" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen> </iframe> </body> </html> """ webView.loadHTMLString(html, baseURL: URL(string: "https://www.youtube.com")) }
3. 用测试视频排除问题
找一个YouTube官方明确允许嵌入的公开视频（比如经典的Rickroll视频，ID是dQw4w9WgXcQ）替换你当前的youtubeId测试：
- 如果这个测试视频能正常播放，说明问题出在你原来的视频权限上
- 如果还是报错，再回头检查WebView的配置细节
4. 补充错误监听，定位更详细的问题
你已经设置了WKNavigationDelegate，可以加上失败回调打印详细错误，方便排查：
func webView(_ webView: WKWebView, didFail navigation: WKNavigation!, withError error: Error) { print("WebView加载失败详情：\(error.localizedDescription)") } func webView(_ webView: WKWebView, didFailProvisionalNavigation navigation: WKNavigation!, withError error: Error) { print("WebView初始导航失败详情：\(error.localizedDescription)") }
这些日志能帮你更精准地知道是网络问题、权限问题还是其他配置问题。
5. 确认App的ATS配置
确保你的Info.plist里的ATS（App Transport Security）设置没有阻止YouTube的HTTPS请求：
- 如果你开了
NSAllowsArbitraryLoads，记得给youtube.com加例外规则，允许HTTPS请求； - 如果没改ATS，默认配置是允许所有HTTPS请求的，这一步可以跳过。
总结
先从视频嵌入权限入手排查，这是最容易忽略也是最常见的原因；如果权限没问题，再调整代码里的iframe参数和补充错误监听，基本就能解决Error 152-4的问题啦。
备注：内容来源于stack exchange，提问作者d0tb0t
