ASP.NET Core Web API生产环境物理存储PDF上传失败求助

核心原因 #

部署到IIS后，Web API运行在应用池的身份下，该账户没有目标文件夹的写入权限，导致无法创建或写入PDF文件。

具体解决步骤 #

1. 配置uploads文件夹的权限 #

• 定位到服务器上Web API部署目录下的uploads文件夹（如果文件夹不存在，手动创建）。
• 右键文件夹 → 属性 → 安全选项卡 → 编辑 → 添加。
• 根据应用池的身份类型输入账户名：
  • 若使用默认的ApplicationPoolIdentity，输入IIS AppPool\[你的应用池名称]（例如IIS AppPool/MyEquipmentApiPool）。
  • 若使用自定义服务账户，直接输入该账户名称。
• 为添加的账户勾选写入和修改权限，依次点击确定保存设置。

2. 优化文件存储路径（推荐） #

生产环境中，网站根目录的权限通常严格限制，建议将上传文件存储到服务器的独立目录（比如D:\EquipmentUploads），避免权限冲突：

[HttpPost]
public async Task<ActionResult> Upload([FromForm] UploadModel uploadModel)
{
    // 从配置读取或直接指定独立存储路径
    var uploadRootPath = @"D:\EquipmentUploads";
    // 确保目录存在
    if (!Directory.Exists(uploadRootPath))
    {
        Directory.CreateDirectory(uploadRootPath);
    }

    var fileName = Path.Combine(uploadRootPath, 
                                $"{uploadModel.ImeiOrSerial}{uploadModel.EquipmentInvoice.FileName}");

    await uploadModel.EquipmentInvoice.CopyToAsync(new FileStream(fileName, FileMode.Create));

    // 后续数据库操作代码保持不变
    using (var context = _context)
    {
         var equipment = new Equipment
         {
             TypeOfEquipment = uploadModel.TypeOfEquipment,
             EquipmentBrand = uploadModel.EquipmentBrand,
             ModelOrReference = uploadModel.ModelOrReference,
             ImeiOrSerial = uploadModel.ImeiOrSerial,
             Path = Path.GetFileName(fileName) // 只存文件名，避免存储绝对路径
         };

         _context.Equipment.Add(equipment);
         await _context.SaveChangesAsync();

         return Ok(await _context.Equipment.FindAsync(equipment.IdEquipment));
     }
}

完成代码修改后，记得给D:\EquipmentUploads文件夹配置相同的应用池账户写入权限。

3. 验证应用池身份配置 #

• 打开IIS管理器，找到你的Web API对应的应用池。
• 右键应用池 → 高级设置，查看进程模型下的标识：
  • 若使用ApplicationPoolIdentity，确认文件夹权限已正确添加对应账户。
  • 若使用LocalSystem或LocalService，这类账户权限较高但安全性差，不推荐生产环境使用；若必须使用，也要确保它们拥有目标文件夹的写入权限。

4. 处理大文件上传限制（可选） #

如果上传的PDF文件较大，还需要调整IIS和ASP.NET Core的请求大小限制：

• 在Web.config中添加：

<system.webServer>
  <security>
    <requestFiltering>
      <!-- 设置最大允许上传大小为50MB，按需调整 -->
      <requestLimits maxAllowedContentLength="52428800" />
    </requestFiltering>
  </security>
</system.webServer>

• 在Program.cs中配置ASP.NET Core的表单选项：

builder.Services.Configure<FormOptions>(options =>
{
    // 大小和IIS配置保持一致
    options.MultipartBodyLengthLimit = 52428800;
});

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