C#文件上传问题：Web方法无法接收随文件发送的表单数据

我的Web方法 #

[HttpPost]
public async Task<IActionResult> UploadFile2(IFormFile file, int idPackage)
{
    string output = $"{file.FileName} - {file.Length} - {idPackage}";
    return Ok(output);
}

Postman请求 #

POST https://localhost:7006/api/upload/UploadFile2 HTTP/1.1
User-Agent: PostmanRuntime/7.29.2
Accept: */*
Postman-Token: fc51918c-f03f-4e29-9726-6a5159dcb035
Host: localhost:7006
Accept-Encoding: gzip, deflate, br
Connection: keep-alive
Content-Type: multipart/form-data; boundary=--------------------------368567246425722572627984
Content-Length: 363

----------------------------368567246425722572627984
Content-Disposition: form-data; name="idPackage"

1247
----------------------------368567246425722572627984
Content-Disposition: form-data; name="file"; filename="dummy.dat"
Content-Type: application/octet-stream

dummy data from the dummy file
----------------------------368567246425722572627984--

问题描述 #

file参数可正常接收上传文件，但idPackage参数始终为默认值0，尽管已发送值1247。

更新1 #

相同Web请求在另一项目中可正常工作，推测是服务器端请求处理设置问题，但暂未知具体项。

更新2 #

排除Newtonsoft JSON解析器配置问题后仍未找到原因，请问如何调试C#处理Web请求的内部过程？

调试方案 #

1. 开启请求绑定日志 #

在appsettings.json中添加日志配置，将MVC模型绑定相关日志级别设为Debug，能输出绑定的详细过程：

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore.Mvc.ModelBinding": "Debug"
    }
  }
}

启动项目后查看控制台或日志文件，会显示参数是否被识别、绑定失败的具体原因。

2. 断点调试请求上下文 #

• 在控制器方法第一行打断点，调试时查看HttpContext.Request.Form集合，确认是否存在idPackage键，对应的值是否为1247。如果Form里无此字段，说明请求表单名称与参数名存在不兼容；如果有，说明模型绑定环节出问题。
• 若要深入绑定流程，关闭Visual Studio的「仅我的代码」选项，在Microsoft.AspNetCore.Mvc.ModelBinding命名空间下的核心类（如DefaultModelBinder）设置断点，跟踪绑定的每一步。

3. 显式指定绑定源 #

临时给idPackage参数添加[FromForm]特性，强制从表单绑定：

public async Task<IActionResult> UploadFile2(IFormFile file, [FromForm] int idPackage)

如果添加后参数能正常取值，说明项目全局修改了默认绑定源（比如优先从请求Body绑定而非Form）。

4. 排查请求管道中间件 #

检查Program.cs（或Startup.cs）的请求管道配置，确认是否有自定义中间件提前读取了Request.Body，导致后续模型绑定无法获取表单数据。可以注释掉非必要的中间件，逐步测试定位问题。

5. 对比正常项目的配置 #

将当前项目的服务配置（如AddControllers、AddMvc的选项）与正常工作的项目逐一对比，重点关注模型绑定相关的全局设置，比如是否自定义了模型绑定器、是否修改了默认绑定源优先级。

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