0

0

c# webclient 和 httpclient 的区别

畫卷琴夢

畫卷琴夢

发布时间:2026-01-15 08:38:02

|

666人浏览过

|

来源于php中文网

原创

WebClient 将非2xx状态码视为异常直接抛出WebException,而HttpClient仅在网络错误时抛HttpRequestException,正常HTTP错误需手动检查StatusCode。

c# webclient 和 httpclient 的区别

WebClient 一调就报 WebException,HttpClient 却不抛异常?

这是最常踩的坑:用 WebClient 请求一个返回 404 或 500 的 API,代码直接崩在 DownloadString 上,抛出 WebException;而换成 HttpClientGetAsync 照常返回 HttpResponseMessage,得手动检查 response.IsSuccessStatusCode 才知道失败了。

  • WebClient 把所有非 2xx 状态码当“异常”处理(哪怕 404 是你预期的业务结果)
  • HttpClient 只在真正出问题时才抛 HttpRequestException(比如 DNS 失败、连接超时、服务器完全不可达)
  • 这意味着:用 WebClient 你得 try-catch 每次调用;用 HttpClient 你可以统一判断 StatusCode,再分情况处理(如 401 跳登录、404 提示资源不存在)

为什么 new HttpClient() 用几次就卡死或报 SocketException?

这不是 bug,是误用。很多人照着示例写 using (var client = new HttpClient()),结果高并发下出现 SocketException: Only one usage of each socket address is normally permitted

  • HttpClient 设计为**长生命周期复用**,不是一次性的 —— 它背后维护 TCP 连接池
  • 每次 new HttpClient() 都新建连接池,频繁创建销毁会快速耗尽本地端口(TIME_WAIT 状态堆积)
  • WebClient 虽也有类似风险,但因默认同步+低并发场景多,问题不明显;而 HttpClient 异步高频使用时立刻暴露
  • 正确做法:全局单例、DI 注入 IHttpClientFactory,或至少在类级别复用实例

上传文件、下载大文件,该选哪个?

看需求粒度。如果只是“把本地文件发到某个 URL”,WebClient.UploadFile 一行搞定;但如果要监控进度、设超时、加 token、支持断点续传、或上传流式数据(比如压缩中上传),HttpClient 是唯一选择。

网钛淘拍CMS(TaoPaiCMS) V1.60
网钛淘拍CMS(TaoPaiCMS) V1.60

2013年07月06日 V1.60 升级包更新方式:admin文件夹改成你后台目录名,然后补丁包里的所有文件覆盖进去。1.[新增]后台引导页加入非IE浏览器提示,后台部分功能在非IE浏览器下可能没法使用2.[改进]淘客商品管理 首页 列表页 内容页 的下拉项加入颜色来区别不同项3.[改进]后台新增/修改淘客商品,增加淘宝字样的图标和天猫字样图标改成天猫logo图标4.[改进]为统一名称,“分类”改

下载
  • WebClient:只支持完整文件路径上传,不支持 Stream 或分块;无进度回调;不能设 Timeout(只能靠底层 WebRequest 默认值)
  • HttpClient:可传 StreamContent、设 client.Timeout = TimeSpan.FromSeconds(60)、用 Progress 监听上传进度、支持 CancelToken 中断
  • 注意:WebClientUploadFileAsync 声称异步,但底层仍是同步 I/O 封装,无法真正释放线程;HttpClient 的异步才是真正的 awaitable I/O

新项目里还能用 WebClient 吗?

能,但不建议。.NET 官方已将 WebClient 标记为 [Obsolete](https://learn.microsoft.com/en-us/do.net/api/system.net.webclient?view=net-8.0#remarks)(自 .NET 6 起警告,.NET 8+ 默认启用警告)。

  • 它不支持 HTTP/2、不支持请求拦截器、不能配置消息处理器链(比如自动加 Auth Header)、无法集成 Polly 重试
  • 所有现代库(如 Refit、Flurl)都基于 HttpClient 构建;第三方认证库(Microsoft.Identity.Web)也只提供 HttpClient 扩展
  • 例外场景:写个临时控制台工具快速抓网页内容,new WebClient().DownloadString(url) 确实快——但这种“快”是以牺牲可维护性和未来扩展性换来的

真正容易被忽略的点是:异常语义差异不是风格偏好,而是设计契约。把 404 当异常捕获,等于把“资源不存在”当成程序错误;而把它作为正常响应处理,才能写出可预测、可观测、易测试的 HTTP 客户端逻辑。

相关专题

更多
登录token无效
登录token无效

登录token无效解决方法:1、检查token的有效期限,如果token已经过期,需要重新获取一个新的token;2、检查token的签名,如果签名不正确,需要重新获取一个新的token;3、检查密钥的正确性,如果密钥不正确,需要重新获取一个新的token;4、使用HTTPS协议传输token,建议使用HTTPS协议进行传输 ;5、使用双因素认证,双因素认证可以提高账户的安全性。

6084

2023.09.14

登录token无效怎么办
登录token无效怎么办

登录token无效的解决办法有检查Token是否过期、检查Token是否正确、检查Token是否被篡改、检查Token是否与用户匹配、清除缓存或Cookie、检查网络连接和服务器状态、重新登录或请求新的Token、联系技术支持或开发人员等。本专题为大家提供token相关的文章、下载、课程内容,供大家免费下载体验。

803

2023.09.14

token怎么获取
token怎么获取

获取token值的方法:1、小程序调用“wx.login()”获取 临时登录凭证code,并回传到开发者服务器;2、开发者服务器以code换取,用户唯一标识openid和会话密钥“session_key”。想了解更详细的内容,可以阅读本专题下面的文章。

1059

2023.12.21

token什么意思
token什么意思

token是一种用于表示用户权限、记录交易信息、支付虚拟货币的数字货币。可以用来在特定的网络上进行交易,用来购买或出售特定的虚拟货币,也可以用来支付特定的服务费用。想了解更多token什么意思的相关内容可以访问本专题下面的文章。

1220

2024.03.01

堆和栈的区别
堆和栈的区别

堆和栈的区别:1、内存分配方式不同;2、大小不同;3、数据访问方式不同;4、数据的生命周期。本专题为大家提供堆和栈的区别的相关的文章、下载、课程内容,供大家免费下载体验。

388

2023.07.18

堆和栈区别
堆和栈区别

堆(Heap)和栈(Stack)是计算机中两种常见的内存分配机制。它们在内存管理的方式、分配方式以及使用场景上有很大的区别。本文将详细介绍堆和栈的特点、区别以及各自的使用场景。php中文网给大家带来了相关的教程以及文章欢迎大家前来学习阅读。

571

2023.08.10

线程和进程的区别
线程和进程的区别

线程和进程的区别:线程是进程的一部分,用于实现并发和并行操作,而线程共享进程的资源,通信更方便快捷,切换开销较小。本专题为大家提供线程和进程区别相关的各种文章、以及下载和课程。

480

2023.08.10

http500解决方法
http500解决方法

http500解决方法有检查服务器日志、检查代码错误、检查服务器配置、检查文件和目录权限、检查资源不足、更新软件版本、重启服务器或寻求专业帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

336

2023.11.09

Java 桌面应用开发(JavaFX 实战)
Java 桌面应用开发(JavaFX 实战)

本专题系统讲解 Java 在桌面应用开发领域的实战应用,重点围绕 JavaFX 框架,涵盖界面布局、控件使用、事件处理、FXML、样式美化(CSS)、多线程与UI响应优化,以及桌面应用的打包与发布。通过完整示例项目,帮助学习者掌握 使用 Java 构建现代化、跨平台桌面应用程序的核心能力。

36

2026.01.14

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Django 教程
Django 教程

共28课时 | 3.1万人学习

SciPy 教程
SciPy 教程

共10课时 | 1.1万人学习

Sass 教程
Sass 教程

共14课时 | 0.8万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号