ASP.NET使用IFormFile上传.apk文件提交返回null问题求助

核心排查方向 #

• 优先排查请求大小限制触发的拦截：ASP.NET默认单请求体大小限制为30MB左右，IIS默认请求长度限制也为30MB，绝大多数APK安装包体积远大于该阈值，触发限制后框架会直接丢弃文件字段，最终IFormFile取值为null；PNG、PDF等常规文件体积较小，通常不会触发该限制，因此可以正常上传。
• 排查IIS请求筛选规则拦截：IIS默认请求筛选模块会对未在允许列表内的扩展名做拦截，APK属于安卓可执行安装包，部分默认规则会拦截该扩展名的上传请求，拦截后文件字段会被直接移除。
• 排查安全中间件/过滤器拦截：部分内置或自定义的安全防护中间件，会默认拦截可执行类文件上传，APK后缀会被规则命中导致文件字段被过滤。
• 快速定位技巧：打开浏览器开发者工具，切换到网络面板查看上传请求的载荷，确认multipart/form-data段中确实包含APK文件内容：如果请求中未携带文件，属于前端表单问题；如果请求携带了文件但后端接收为null，即可确定是服务端规则拦截导致。

完整实现步骤 #

1. 配置服务端表单大小限制
   在ASP.NET Core项目的Program.cs中，修改表单选项的多部分请求体长度阈值，示例配置支持最大1GB的APK文件上传：

builder.Services.Configure<FormOptions>(options =>
{
    options.MultipartBodyLengthLimit = 1024 * 1024 * 1024; // 单位为字节，此处配置为1GB
});

2. 配置IIS部署参数
   如果项目部署在IIS上，需要在项目根目录的web.config中添加配置，调整请求长度限制并允许APK扩展名上传：

<system.webServer>
  <security>
    <requestFiltering>
      <!-- 配置最大请求长度，单位为字节，和服务端配置保持一致 -->
      <requestLimits maxAllowedContentLength="1073741824" />
      <fileExtensions>
        <!-- 移除默认可能存在的APK拦截规则，添加允许规则 -->
        <remove fileExtension=".apk" />
        <add fileExtension=".apk" allowed="true" />
      </fileExtensions>
    </requestFiltering>
  </security>
</system.webServer>

3. 给上传接口添加大小限制特性
   在接收文件的控制器Action或者Razor Pages处理方法上，添加请求大小限制相关特性，避免被全局默认规则拦截：

[HttpPost]
// 可根据需求选择完全关闭大小限制，或指定具体阈值
// [DisableRequestSizeLimit]
[RequestSizeLimit(1073741824)]
public async Task<IActionResult> UploadApk(IFormFile file)
{
    // 校验文件扩展名，避免恶意文件上传
    if (Path.GetExtension(file.FileName).ToLower() != ".apk")
    {
        return BadRequest("仅允许上传APK格式文件");
    }
    // 自行实现文件保存到存储、写入数据库的逻辑
}

注意：后端接收IFormFile的参数名，必须和前端文件input标签的name属性值完全一致（大小写敏感），否则也会出现接收为null的问题。

4. 配置公开访问的静态文件支持
   上传完成的APK需要对公开用户开放访问，需要在静态文件中间件配置中添加APK对应的MIME类型，否则访问时会返回404错误：

// 配置静态文件中间件
app.UseStaticFiles(new StaticFileOptions
{
    ContentTypeProvider = new FileExtensionContentTypeProvider
    {
        Mappings =
        {
            // 添加APK对应的MIME类型
            [".apk"] = "application/vnd.android.package-archive"
        }
    }
});

5. 前端表单参考代码
   确保表单配置正确的enctype属性，文件input配置正确的name和accept属性：

<form method="post" enctype="multipart/form-data">
    <div class="border p-3 mt-4">
        <!-- name属性值必须和后端IFormFile参数名一致 -->
        <input type="file" name="file" accept=".apk" required />
        <button type="submit" class="btn btn-primary mt-2">上传APK</button>
    </div>
</form>

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