Xamarin Forms上传图片未抵达服务端就报发送请求错误，如何解决？

核心错误点（按影响优先级排序） #

• SecurityProtocol 配置顺序错误
  你将TLS协议配置放在了PostAsync请求之后，请求发送时TLS配置还未生效，大概率会引发SSL/TLS握手失败，直接导致请求还没到服务端就报错。必须将该配置移到HTTP请求发送之前，建议在APP启动时全局配置一次即可。
• MultipartFormDataContent 参数格式错误
  content.Add方法的第二个参数（表单字段名）和第三个参数（文件名）额外套了多余的双引号，会导致服务端无法正确识别file字段，也可能引发客户端请求格式化错误，需要去掉多余的转义引号。
• 异步方法未加await
ReadAsStringAsync是异步方法，你没有加await关键字，拿到的只是Task对象而非实际响应内容，虽不是请求失败的直接原因，但会导致后续处理逻辑异常。
• HttpClient 实例使用不规范
  每次请求都新建HttpClient实例会导致端口资源耗尽，引发请求失败，建议全局维护单例HttpClient使用。
• 平台权限/网络限制问题
  • Android 9及以上版本默认禁止明文HTTP请求，如果你的服务端用的是HTTP而非HTTPS，需要在Android项目中配置网络安全策略，放开对应域名的明文访问限制，同时确保已申请INTERNET权限。
  • iOS 默认禁止未ATS认证的HTTP请求，若使用HTTP协议需要在Info.plist中配置ATS例外规则。

修正后的客户端代码 #

// 建议在App启动时全局配置一次即可，不用每次请求都设置
System.Net.ServicePointManager.SecurityProtocol =
    SecurityProtocolType.Tls12 |
    SecurityProtocolType.Tls11 |
    SecurityProtocolType.Tls;

// 建议将httpClient改为全局单例，不要每次请求新建
private static readonly HttpClient _httpClient = new HttpClient();

try
{
    var content = new MultipartFormDataContent();
    // 去掉多余的转义双引号，直接用Path获取文件名更稳妥
    content.Add(new StreamContent(_mediaFile.GetStream()), "file", Path.GetFileName(_mediaFile.Path));

    var uploadUrl = "{你的实际服务端地址}/api/files/upload";
    // 可按需设置超时时间，避免长时间无响应
    _httpClient.Timeout = TimeSpan.FromSeconds(30);

    var httpResponseMessage = await _httpClient.PostAsync(uploadUrl, content);
    // 加await获取实际响应内容
    var response = await httpResponseMessage.Content.ReadAsStringAsync();
}
catch (Exception ex)
{
    // 输出完整异常栈，方便排查更细节的问题
    Console.WriteLine(ex.ToString());
}

额外排查建议 #

如果修改后还是报错，优先查看完整异常栈的内部异常信息：

• 如果是HttpRequestException且内部提到TLS相关错误，确认服务端支持的TLS版本和客户端配置一致
• 如果是域名解析错误/连接超时，确认Xamarin客户端所在设备能正常访问服务端地址，可先用设备浏览器访问服务端接口地址测试连通性

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