Linux环境下ASP.NET Core文件上传异常问题求助

我之前也碰到过几乎一模一样的问题——本地跑文件上传完全正常，一部署到Linux VPS就各种报错。结合你的场景，咱们从最常见的几个坑开始排查：

1. 上传目录的权限问题（最常见！） #

Linux的权限机制和Windows完全不同，ASP.NET Core应用通常以www-data（Nginx/Apache场景）或者你创建的专用用户运行，如果这个用户没有上传目录的读写权限，上传肯定失败。

排查&解决： #

• 先确认你的上传目录路径，比如代码里用的_host.WebRootPath + "/uploads"，对应的服务器路径可能是/var/www/your-app/wwwroot/uploads
• 给目录设置正确的所有者和权限：

  # 把目录所有者改成应用运行用户（比如www-data）
  sudo chown -R www-data:www-data /var/www/your-app/wwwroot/uploads
  # 设置目录权限，确保用户有读写权限
  sudo chmod -R 755 /var/www/your-app/wwwroot/uploads
  

• 如果是CentOS/RHEL这类带SELinux的系统，还要调整目录的安全上下文：

  sudo chcon -Rt httpd_sys_rw_content_t /var/www/your-app/wwwroot/uploads
  

2. 文件上传大小限制被拦截 #

ASP.NET Core和反向代理（Nginx/Apache）都有默认的上传大小限制，本地可能已经调整过，但部署到服务器后没同步配置。

ASP.NET Core端配置： #

在Program.cs里添加FormOptions配置，放开大小限制：

builder.Services.Configure<FormOptions>(options =>
{
    // 设置最大上传文件大小，这里是100MB，按需调整
    options.MultipartBodyLengthLimit = 104857600;
    // 允许的单个文件大小
    options.MultipartHeadersLengthLimit = 104857600;
});

Nginx反向代理配置： #

如果用Nginx做反向代理，需要在nginx.conf或者站点配置里添加：

server {
    # ...其他配置
    client_max_body_size 100M; # 和ASP.NET Core的限制保持一致
}

修改后记得重启Nginx：sudo systemctl restart nginx

3. 跨平台路径拼接错误 #

Windows用反斜杠\，Linux用正斜杠/，如果代码里硬编码了路径分隔符，或者没使用Path.Combine，就会在Linux下生成无效路径。

错误示例（不要这么写）： #

var savePath = _host.WebRootPath + "\\uploads\\" + fileName; // 硬编码反斜杠，Linux下会出错

正确写法（跨平台兼容）： #

var savePath = Path.Combine(_host.WebRootPath, "uploads", fileName);

4. 临时目录权限问题 #

ASP.NET Core处理上传文件时，会先把文件写到临时目录（默认是系统的/tmp），如果应用运行用户没有这个目录的访问权限，也会抛出异常。

排查&解决： #

• 检查/tmp目录权限：ls -ld /tmp，确保其他用户有读写权限（权限通常是drwxrwxrwt）
• 如果系统临时目录有问题，可以自定义临时目录：

  builder.Services.Configure<FormOptions>(options =>
  {
      // 在应用目录下创建temp文件夹，然后配置为临时目录
      options.TemporaryFileDirectory = Path.Combine(builder.Environment.ContentRootPath, "temp");
  });
  

  之后给这个temp目录设置和上传目录一样的权限。

最后：查看具体异常日志 #

如果上面的排查都没解决问题，一定要看具体的异常信息：

• ASP.NET Core的日志默认会输出到控制台，或者你配置的日志文件（比如/var/log/your-app/目录下）
• Linux系统日志可以查看/var/log/syslog（Debian/Ubuntu）或者/var/log/messages（CentOS/RHEL），里面可能会有文件权限、磁盘空间不足等细节。

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