Android模拟器无法访问YouTube API问题求助

问题概述 #

基于Windows系统+Visual Studio 2022 v17.3.3开发.NET MAUI YouTube克隆应用时，仅Android模拟器调用YouTube API会超时，Windows本地运行、实体Android设备（Samsung Note 10+）、Postman均能正常请求。代码卡在var response = await _httpClient.GetAsync(new Uri(_httpClient.BaseAddress, resource));行。

可能原因及解决办法 #

1. 模拟器网络配置异常 #

Android模拟器默认网络模式可能无法正常访问外部SSL服务：

• 切换网络模式：打开模拟器右侧的Extended Controls（三个点图标）→ Settings → Network，将Network Mode改为Bridge（桥接物理网卡）或LTE，重启模拟器后重试。
• 检查代理设置：如果本地开启了代理软件，需在模拟器中配置对应代理，或者直接关闭本地代理后测试。

2. Android权限缺失 #

确认AndroidManifest.xml中已添加必要网络权限：

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

注：.NET MAUI默认会自动添加INTERNET权限，但手动修改清单文件后可能丢失，需核实。

3. HttpClient配置兼容性问题 #

模拟器对HttpClient默认配置可能存在兼容问题，尝试显式配置Handler：

// 创建HttpClient时添加以下配置
var handler = new HttpClientHandler
{
    UseProxy = false, // 无需代理时禁用
    AllowAutoRedirect = true,
    // 临时跳过证书验证（仅测试用，正式环境必须移除）
    ServerCertificateCustomValidationCallback = (sender, cert, chain, sslPolicyErrors) => true 
};

_httpClient = new HttpClient(handler)
{
    BaseAddress = new Uri("https://www.googleapis.com/youtube/v3/") // 确保BaseAddress正确
};

4. 请求URL拼接错误 #

当前代码拼接pageToken时缺少&符号，导致URL格式无效：
错误代码：

var resouceUri = $"search?part=snippet&maxResults=20&type=video&key={Constants.ApiKey}&q={WebUtility.UrlEncode(searchQuery)}" +
    (!string.IsNullOrWhiteSpace(nextPageToken) ? $"pageToken={nextPageToken}" : "");

修改为：

var resouceUri = $"search?part=snippet&maxResults=20&type=video&key={Constants.ApiKey}&q={WebUtility.UrlEncode(searchQuery)}" +
    (!string.IsNullOrWhiteSpace(nextPageToken) ? $"&pageToken={nextPageToken}" : "");

该错误可能在其他环境因API容错或缓存暂时生效，但模拟器环境直接导致请求超时。

5. 模拟器系统版本兼容问题 #

尝试更换不同Android版本的模拟器，比如从Android 13切换到Android 11，部分新版本模拟器的网络栈可能存在兼容性bug。

调试建议 #

• 在模拟器浏览器中直接访问YouTube API测试URL（如https://www.googleapis.com/youtube/v3/search?part=snippet&maxResults=1&type=video&key=你的API_KEY&q=test），确认网络和API密钥是否正常。
• 给请求添加超时设置并捕获异常日志：

try
{
    // 设置10秒超时
    var response = await _httpClient.GetAsync(new Uri(_httpClient.BaseAddress, resource), TimeSpan.FromSeconds(10)); 
    response.EnsureSuccessStatusCode();
}
catch (TaskCanceledException ex)
{
    Console.WriteLine($"请求超时: {ex.Message}");
}
catch (Exception ex)
{
    Console.WriteLine($"请求异常: {ex.Message}");
}

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