C#文件上传无通用方案，需按服务器协议选HTTP表单、Web API、FTP/SFTP或云SDK；HTTP上传须用MultipartFormDataContent避免边界符/头格式错误；云API需严格签名；大文件须分片；WinForms/WPF进度条要用CopyToAsync+IProgress；ASP.NET Framework需配web.config三处上传限制。
直接说结论：C# 上传文件到服务器没有“通用一键方案”，必须根据目标服务器支持的协议和接口来选型——HTTP 表单上传、Web API 调用、FTP/SFTP 或云厂商 SDK 是四大主流路径，选错就卡在 405 Method Not Allowed 或 400 Bad Request 上。
用 HttpClient 发送 multipart/form-data 最常用也最易翻车
这是 Web 场景下最典型的上传方式，但坑集中在边界符（boundary）、Content-Type 头、流读取顺序三处。比如手动拼接 multipart body 时，漏掉末尾的 --boundary--\r\n，服务端就收不到完整数据；又或者把 Content-Type: multipart/form-data; boundary=xxx 写成 multipart/form-data;boundary=xxx（少空格），某些严格解析的后端（如 Spring Boot 默认配置）会直接拒收。
- 务必用
HttpClient的MultipartFormDataContent类构造请求体，别手写字符串 -
HttpContent添加顺序要和后端预期一致：先文件字段，再其他表单字段（如userId、token） - 大文件上传前设
httpClient.Timeout = TimeSpan.FromMinutes(10)，否则默认 100 秒超时直接中断 - 若后端是 ASP.NET Core，接收端必须用
IFormFile，且控制器方法参数名（如uploadFile）要和前端contentDisposition中的name值完全一致
调用云厂商 REST API（如腾讯云 COS、阿里云 OSS）必须带签名
这类上传不是发个 POST 就完事。比如腾讯云 COS 的 PUT Object 接口，要求你在请求头里带上 Authorization 签名，而签名依赖 SecretId、SecretKey、当前时间戳、HTTP 方法、URI、body hash 等 6–8 个变量组合加密。用错算法（比如该用 SHA-256 却用了 MD5）、时间偏移超过 15 分钟、或 URI 编码不规范，都会返回 403 Forbidden 并附带模糊错误码 SignatureDoesNotMatch。
- 优先用官方 SDK（如
CosXml或Aliyun.OSS.SDK），它自动处理签名、分片、重试 - 若必须手写 HTTP 请求，别自己实现签名逻辑——抄 SDK 源码里的
Sign方法比从文档推公式更可靠 - 上传大文件务必启用分片上传（
CreateMultipartUpload→UploadPart→CompleteMultipartUpload），单次 PUT 限制通常为 5GB，且无断点续传能力
WinForms/WPF 客户端上传时进度条不准？问题出在流读取方式
很多人用 FileStream.Read() 配合循环 + Thread.Sleep 更新 UI，结果进度跳变、卡顿、甚至抛 InvalidOperationException: The calling thread cannot access this object。根本原因是 UI 线程被阻塞，而进度更新又试图跨线程操作控件。
- 改用
Stream.CopyToAsync(Stream destination, int bufferSize, IProgress<long> progress)</long>，其中IProgress<long></long>回调天然支持 UI 线程同步 - bufferSize 别设太小（如 1KB），否则频繁回调拖慢整体速度；建议 8192 或 65536
- 别在回调里做耗时操作（如格式化字符串、查数据库），只更新
ProgressBar.Value和Label.Text - 上传完成前禁用按钮，防止用户重复点击触发多个并发请求
ASP.NET Framework 后端接收文件时 Request.Files 为空？检查 web.config
这是 .NET Framework 旧项目最常踩的坑：Request.Files.Count 始终为 0，但前端确认已发 multipart 数据。根本原因几乎全是配置项限制——IIS 或 ASP.NET 自身对上传大小、请求长度、执行超时做了硬性拦截，请求根本没进你的代码。
- 确认
web.config中同时设置了三处：<httpruntime maxrequestlength="2097151" executiontimeout="3600"></httpruntime>（单位 KB）、<requestlimits maxallowedcontentlength="2147483647"></requestlimits>（单位 byte）、<security><requestfiltering><requestlimits maxallowedcontentlength="2147483647"></requestlimits></requestfiltering></security> -
maxRequestLength和maxAllowedContentLength数值要匹配，且后者必须 ≥ 前者 × 1024 - 如果部署在 IIS 10+，还需检查模块是否启用了
RequestFilteringModule，禁用会导致配置失效
真正麻烦的从来不是“怎么写上传代码”，而是你得先搞清服务器那头到底等着你交什么格式、签什么名、走哪条协议——连 405 错误都可能是因为对方只开了 GET，而你发了 POST。
