API在IIS Express正常但IIS部署后文件上传报500错误

我开发了一个接收文件上传的WebAPI，Swagger调试端口5146时所有功能（含文件上传）正常，但部署到IIS并设置端口8000后，通过Postman调用文件上传接口出现500内部服务器错误。相关代码如下：

客户端上传代码 #

public static async Task UploadUserPic(MainWindow mainW, ImageBrush IMGbrush)
{
    using (HttpClient client = new HttpClient())
    {
        client.Timeout = TimeSpan.FromSeconds(5);
        string uri =  mainW.ApiUri + "resources/UploadUserPic?id=" + mainW.UBI.ID;
        //var path = @"C:\Users\Kian\Desktop\20220213_08402dd5.jpg";
        var recuestcontent = new MultipartFormDataContent();
        //var filestream = File.OpenRead(path);
        var bmp = new BitmapImage();
        var str = new MemoryStream(Convert.FromBase64String(Convertors.ToString(IMGbrush)));
        recuestcontent.Add(new StreamContent(str), "iformfile", mainW.UBI.ID);
        client.PostAsync(uri, recuestcontent).Wait();
        
    }
}

控制器代码 #

// POST api/UsersController
[HttpPost("UploadUserPic")]
public async Task<IActionResult> UploadUserPic([FromForm] IFormFile iformfile, string id)
{
    var resault = await resource_service.UploadUserPic(iformfile, id);
    return Ok(resault);
}

服务层代码 #

public async Task<string> UploadUserPic(IFormFile iformfile,string id)
{
        File.WriteAllText(@"C:\Users\Kian\Desktop\info.txt", "Got");
    string? filename = null;
    try
    {
        filename = id + ".jpg";

        string fileDIR = MyClasses.Paths.ResourcesDirectory() + "UsersPics\\";

        if (!Directory.Exists(fileDIR))
            Directory.CreateDirectory(fileDIR);

        string filepath = fileDIR + filename;


        if (File.Exists(filepath))
        {
            File.Delete(filepath);
        }

        using (var filestream = new FileStream(filepath, FileMode.Create))
        {
            await iformfile.CopyToAsync(filestream);
        }
        return filename;
    }
    catch
    {

    }

    return filename;
}

路径处理代码 #

public static string GetCurentDirectory()
{
    var resault = Directory.GetCurrentDirectory();
    return resault;
}

public static string ResourcesDirectory()
{
    var resault = Path.Combine(Directory.GetCurrentDirectory(), "Resources\\");
    if (!Directory.Exists(resault))
        Directory.CreateDirectory(resault);

    return resault;
}

问题排查与解决方案 #

1. 权限问题（最可能原因） #

IIS应用程序池默认使用ApplicationPoolIdentity或Network Service账户，这类账户对服务器目录（尤其是代码中生成的Resources文件夹）通常没有读写权限：

• 找到WebAPI部署目录下实际生成的Resources文件夹（可通过临时输出ResourcesDirectory()的返回值确认路径）；
• 右键文件夹→属性→安全→添加IIS应用程序池账户（格式为IIS AppPool\[你的应用程序池名称]），授予修改、写入、读取权限。

2. 捕获具体异常信息 #

当前服务层的catch块为空，无法定位错误根源，修改代码输出异常详情：

catch (Exception ex)
{
    // 写入到有写入权限的目录，比如C盘临时文件夹
    File.WriteAllText(@"C:\Temp\UploadError.log", $"[{DateTime.Now}] 错误：{ex.Message}\n堆栈：{ex.StackTrace}");
    throw; // 重新抛出异常，让客户端能看到具体错误
}

通过日志可直接得知错误类型，比如权限不足、路径不存在、文件被占用等。

3. 路径拼接规范化 #

代码中直接用字符串拼接路径易出现分隔符问题，改用Path.Combine处理：

// 替换原路径拼接代码
string fileDIR = Path.Combine(MyClasses.Paths.ResourcesDirectory(), "UsersPics");
// 同时修改ResourcesDirectory()中的参数，去掉多余的斜杠
public static string ResourcesDirectory()
{
    var resault = Path.Combine(Directory.GetCurrentDirectory(), "Resources");
    if (!Directory.Exists(resault))
        Directory.CreateDirectory(resault);

    return resault;
}

4. 客户端调用优化 #

客户端用Wait()同步阻塞调用易引发超时或死锁，改用await：

await client.PostAsync(uri, recuestcontent);

同时检查mainW.ApiUri是否正确指向http://localhost:8000/，确保拼接后的URL格式正确（比如末尾带斜杠，避免出现localhost:8000resources/...的错误路径）。

5. 调整IIS上传文件限制 #

IIS默认限制上传文件大小（约30MB），若上传文件过大触发500错误，可在Web.config中添加配置：

<system.webServer>
  <security>
    <requestFiltering>
      <!-- 允许最大上传100MB -->
      <requestLimits maxAllowedContentLength="104857600" />
    </requestFiltering>
  </security>
</system.webServer>
<system.web>
  <!-- ASP.NET对应请求限制，单位为KB -->
  <httpRuntime maxRequestLength="102400" />
</system.web>

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