AVPlayer无法播放含特殊字符的HLS流URL问题求助

这个问题我之前也踩过坑，核心原因是AWS MediaConvert生成的M3U8里用了未URL编码的特殊字符文件名，而AVPlayer不会自动对这些文件名编码就发起请求，导致服务器找不到对应TS文件（VLC会自动处理编码逻辑，所以能正常播放）。下面给你几个可行的解决方案，按优先级排序：

1. 从根源解决：预处理上传的文件名（最推荐） #

在用户上传视频时，直接把含特殊字符的文件名转换成URL编码后的格式，再存储和传给MediaConvert转码。比如把😂.mp4转换成%F0%9F%98%82.mp4。这样转码后生成的M3U8和TS文件名都是URL编码后的，AVPlayer请求时会直接匹配服务器上的文件路径，彻底避免404问题。

2. 客户端自定义M3U8解析（无需修改后端/转码流程） #

如果没法修改上传或转码流程，可以在客户端获取M3U8内容后，手动把里面未编码的TS文件名替换成URL编码后的版本，再传给AVPlayer。以下是Swift代码示例：

func loadEncodedPlaylist(from url: URL, completion: @escaping (URL?) -> Void) {
    let task = URLSession.shared.dataTask(with: url) { data, response, error in
        guard let data = data, let playlistContent = String(data: data, encoding: .utf8) else {
            completion(nil)
            return
        }
        
        // 拆分M3U8每一行，只处理TS片段行
        let processedLines = playlistContent.components(separatedBy: .newlines).map { line in
            guard line.hasSuffix(".ts") else { return line }
            // 对TS文件名进行URL路径编码
            return line.addingPercentEncoding(withAllowedCharacters: .urlPathAllowed) ?? line
        }
        
        // 将处理后的内容写入临时文件（AVPlayer需要URL加载）
        let tempFileURL = URL(fileURLWithPath: NSTemporaryDirectory())
            .appendingPathComponent("encoded_playlist_\(UUID()).m3u8")
        
        do {
            try processedLines.joined(separator: "\n").write(to: tempFileURL, atomically: true, encoding: .utf8)
            completion(tempFileURL)
        } catch {
            print("Failed to write encoded playlist: \(error)")
            completion(nil)
        }
    }
    task.resume()
}

// 使用示例
if let originalPlaylistURL = URL(string: "https://.../%F0%9F%98%82.m3u8") {
    loadEncodedPlaylist(from: originalPlaylistURL) { encodedURL in
        guard let encodedURL = encodedURL else { return }
        let player = AVPlayer(url: encodedURL)
        // 后续播放逻辑（比如关联AVPlayerLayer、开始播放等）
    }
}

这个方法逻辑很清晰：先拉取原始M3U8内容，识别出所有TS片段的文件名并编码，然后生成一个本地临时M3U8文件，让AVPlayer加载这个临时文件，这样它请求的TS片段就是编码后的路径了。

3. 服务器端配置（需要服务器权限） #

如果你有权限修改服务器（比如Nginx）的配置，可以添加规则，自动将未编码的请求路径转换为URL编码后的路径去查找文件。例如，使用Nginx的ngx_http_set_misc_module模块来处理编码转换：

location ~* \.ts$ {
    # 解码请求路径，再重新编码
    set_unescape_uri $decoded_uri $uri;
    set_url_encode $encoded_uri $decoded_uri;
    # 转发到原始存储服务
    proxy_pass https://your-storage-origin$encoded_uri;
}

注意：这个方案需要Nginx安装对应的模块，配置成本较高，适合无法修改客户端或上传流程的场景。

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