Xamarin.Forms应用MP4视频下载过慢易崩溃问题求助

一、先解决应用崩溃问题：核心是异步+非阻塞UI+异常处理 #

崩溃大概率是因为你在UI线程同步执行下载操作，导致主线程卡死被系统杀掉，或者未处理超时、异常场景。

1. 强制用异步下载，绝不阻塞UI线程 #

所有网络操作必须放在后台线程，用async/await处理，避免主线程阻塞：

// 错误示例：同步调用直接阻塞UI
var response = httpClient.GetAsync(url).Result; 

// 正确写法：异步分块读写，不占满内存也不阻塞UI
public async Task DownloadVideoAsync(string videoUrl, string savePath, IProgress<int> progress, CancellationToken token)
{
    try
    {
        // 先读取响应头，不直接加载整个文件到内存
        using var response = await _httpClient.GetAsync(videoUrl, HttpCompletionOption.ResponseHeadersRead, token);
        response.EnsureSuccessStatusCode();
        
        var totalBytes = response.Content.Headers.ContentLength ?? 0;
        using var stream = await response.Content.ReadAsStreamAsync(token);
        using var fileStream = new FileStream(savePath, FileMode.Create, FileAccess.Write, FileShare.None, 8192, true);
        
        var buffer = new byte[8192];
        long totalRead = 0;
        int bytesRead;
        
        while ((bytesRead = await stream.ReadAsync(buffer, 0, buffer.Length, token)) > 0)
        {
            await fileStream.WriteAsync(buffer, 0, bytesRead, token);
            totalRead += bytesRead;
            
            // 上报下载进度，注意在UI线程更新控件
            if (totalBytes > 0)
            {
                progress.Report((int)((totalRead * 100) / totalBytes));
            }
            
            token.ThrowIfCancellationRequested();
        }
    }
    catch (OperationCanceledException)
    {
        // 处理用户主动取消或超时的情况
        if (File.Exists(savePath)) File.Delete(savePath);
    }
    catch (Exception ex)
    {
        Debug.WriteLine($"下载失败：{ex.Message}");
        if (File.Exists(savePath)) File.Delete(savePath);
    }
}

2. 添加超时与取消机制 #

给下载操作设置合理超时，同时允许用户中断下载：

// 10分钟超时的取消令牌
using var cts = new CancellationTokenSource(TimeSpan.FromMinutes(10));
// 进度回调，更新UI进度条
var progress = new Progress<int>(percent => {
    Device.BeginInvokeOnMainThread(() => {
        DownloadProgressBar.Progress = percent / 100.0;
    });
});

// 异步执行下载，不阻塞UI
await DownloadVideoAsync(videoUrl, savePath, progress, cts.Token);

3. 内存优化 #

使用HttpCompletionOption.ResponseHeadersRead只先读取响应头，分块读写流，避免一次性把几十上百MB的视频读到内存里导致OOM崩溃。

二、优化下载速度：API端+客户端双向优化 #

API端优化 #

1. 启用HTTP范围请求（断点续传）
   让API支持Range请求，允许客户端分块下载或断点续传，避免单次失败就要从头开始：

// ASP.NET Core API示例：支持范围请求
[HttpGet("videos/{fileName}")]
public async Task<IActionResult> GetVideo(string fileName)
{
    var filePath = Path.Combine("VideoStorage", fileName);
    if (!File.Exists(filePath))
        return NotFound();
    
    var fileInfo = new FileInfo(filePath);
    var rangeHeader = Request.Headers.Range;
    
    // 无范围请求时返回完整文件
    if (rangeHeader == null)
        return File(File.OpenRead(filePath), "video/mp4");
    
    // 解析范围请求的起始、结束位置
    long start = 0;
    long end = fileInfo.Length - 1;
    var rangeValue = rangeHeader.ToString().Replace("bytes=", "");
    var parts = rangeValue.Split('-');
    
    if (parts.Length == 2 && long.TryParse(parts[0], out start))
    {
        if (!long.TryParse(parts[1], out end))
            end = fileInfo.Length - 1;
    }
    
    end = Math.Min(end, fileInfo.Length - 1);
    var contentLength = end - start + 1;
    
    var stream = new FileStream(filePath, FileMode.Open, FileAccess.Read, FileShare.Read);
    stream.Seek(start, SeekOrigin.Begin);
    
    // 设置响应头，告知客户端返回的是部分内容
    Response.Headers.Add("Content-Range", $"bytes {start}-{end}/{fileInfo.Length}");
    Response.Headers.Add("Accept-Ranges", "bytes");
    Response.StatusCode = StatusCodes.Status206PartialContent;
    
    return File(stream, "video/mp4", contentLength);
}

2. 视频压缩与格式优化
   对MP4文件进行压缩：降低分辨率、码率，或转成更高效的H.265编码，直接减少文件大小，从根源缩短下载时间。

3. 启用静态文件缓存
   给视频文件设置缓存头，让客户端可以缓存已下载的内容，重复请求时直接用本地缓存：

// ASP.NET Core配置静态文件缓存
app.UseStaticFiles(new StaticFileOptions
{
    OnPrepareResponse = ctx =>
    {
        // 缓存1天，根据需求调整
        ctx.Context.Response.Headers.Append("Cache-Control", "public, max-age=86400");
    }
});

4. CDN加速
   将视频文件放到CDN节点，让用户从就近的服务器下载，大幅降低延迟、提升下载速度。

客户端优化 #

1. 分块并行下载
   如果API支持范围请求，可以实现多线程分块下载，同时拉取视频的不同部分，最后合并：

public async Task DownloadInChunksAsync(string url, string savePath, int chunkCount = 4)
{
    using var client = _httpClient;
    var response = await client.GetAsync(url, HttpCompletionOption.ResponseHeadersRead);
    var totalBytes = response.Content.Headers.ContentLength ?? 0;
    var chunkSize = totalBytes / chunkCount;
    
    var tasks = new List<Task>();
    var tempFiles = new List<string>();
    
    try
    {
        // 启动多个分块下载任务
        for (int i = 0; i < chunkCount; i++)
        {
            var start = i * chunkSize;
            var end = i == chunkCount - 1 ? totalBytes - 1 : start + chunkSize - 1;
            var tempPath = $"{savePath}.part{i}";
            tempFiles.Add(tempPath);
            
            tasks.Add(DownloadSingleChunk(url, start, end, tempPath));
        }
        
        await Task.WhenAll(tasks);
        
        // 合并分块文件
        using var finalStream = new FileStream(savePath, FileMode.Create);
        foreach (var tempPath in tempFiles)
        {
            using var partStream = new FileStream(tempPath, FileMode.Open);
            await partStream.CopyToAsync(finalStream);
            File.Delete(tempPath);
        }
    }
    catch
    {
        // 出错时清理临时文件
        foreach (var path in tempFiles)
            if (File.Exists(path)) File.Delete(path);
        throw;
    }
}

private async Task DownloadSingleChunk(string url, long start, long end, string savePath)
{
    using var client = _httpClient;
    client.DefaultRequestHeaders.Range = new RangeHeaderValue(start, end);
    
    using var response = await client.GetAsync(url, HttpCompletionOption.ResponseHeadersRead);
    using var stream = await response.Content.ReadAsStreamAsync();
    using var fileStream = new FileStream(savePath, FileMode.Create);
    
    await stream.CopyToAsync(fileStream);
}

2. 复用HttpClient实例
   不要每次下载都新建HttpClient，复用全局单例可以减少TCP连接建立的开销：

// 全局单例HttpClient，在应用启动时初始化
private static readonly HttpClient _httpClient = new HttpClient();

// 初始化配置
public static void InitHttpClient()
{
    _httpClient.Timeout = TimeSpan.FromMinutes(10);
    _httpClient.DefaultRequestHeaders.Add("User-Agent", "XamarinForms-Video-Downloader");
}

三、额外注意事项 #

• 平台权限：Android需申请WRITE_EXTERNAL_STORAGE/READ_MEDIA_VIDEO权限，iOS需配置NSPhotoLibraryAddUsageDescription等存储权限，否则下载会失败。
• 后台下载：如果用户切换到后台，Android可以用ForegroundService维持下载，iOS可以用URLSession的后台下载任务，避免系统暂停下载。

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