文件上传Web API JS客户端调用时filePayload为null？Swagger正常

前后端对FormData的文件字段名约定不一致，这是ASP.NET Core文件上传绑定失效的最常见场景：

• 后端接口定义的文件参数名为 filePayload，ASP.NET Core 的表单模型绑定会严格匹配同名字段来填充IFormFile参数，没有模糊匹配的逻辑
• 前端代码往FormData实例追加文件时，用的字段名是 file，名字对不上自然会被绑定为null
• Swagger调用能正常运行，是因为Swagger自动生成的上传请求会直接读取后端方法的参数名作为Form字段名，完全匹配绑定规则，不会出现命名错位的问题

• 手动设置{'Content-Type': null}的写法存在隐患：不少封装的HTTP请求库会在内部默认给POST请求附带application/json的Content-Type头，哪怕你把对应键的值设为null，库的预处理逻辑也可能把null值替换成默认头，最终导致请求不是带正确boundary的multipart/form-data格式，后端完全无法解析表单内容
• 传入FormData的file变量如果不是合法的File/Blob实例（比如被序列化成base64字符串、或传入了整个FileList数组），也会导致绑定失败
• 部分定制化配置的ASP.NET Core接口，如果上传文件参数没有显式标注[FromForm]特性，在全局模型绑定规则被调整的情况下也可能出现绑定失效，但从你当前描述的现象（confirmId能正常接收、Swagger调用正常）来看，这个不是核心诱因

1. 对齐FormData的字段名，和后端参数名保持完全一致：

   // 将原有 append 逻辑修改为
   body.append('filePayload', file);
   

2. 移除手动设置Content-Type的配置，不要把Content-Type键放到headers对象里，完全交由浏览器根据FormData实例自动生成带boundary的请求头：

   return await XH.fetchJson({ 
       url,
       body,
       method: 'POST',
       // 删除原有的 headers 配置块
   });
   

3. 如果你的XH请求库内部强制附带默认的application/json头，需要在配置中把该头的值设为undefined（不要设null），让库在发送请求时主动移除这个头；最后可以用你之前用的抓包工具验证：最终发出的请求头必须是multipart/form-data; boundary=----xxx的格式，才算符合要求。

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