Hostinger VPS中ASP.NET Core Web API传Base64图片报500错误

1. 启用ASP.NET Core详细错误日志 #

• 修改appsettings.json，将日志级别设为Debug或Trace：

  "Logging": {
    "LogLevel": {
      "Default": "Debug",
      "Microsoft.AspNetCore": "Debug"
    }
  }
  

• 重启API服务后重新触发请求，通过journalctl -u [你的服务名].service查看systemd日志，或直接查看应用日志目录（通常在/var/log/[应用名称]/），重点抓取未处理异常栈信息，比如Base64解码失败、请求体超限、内存不足等具体错误。

2. 调整Nginx请求体大小限制 #

Nginx默认client_max_body_size为1M，Base64图片字符串通常远超这个值，可能被错误转化为500状态码：

• 编辑Nginx站点配置文件（比如/etc/nginx/sites-available/[你的配置文件]）：

  server {
    # 其他配置项
    client_max_body_size 50m; # 根据实际图片大小调整，如50M/100M
    client_body_buffer_size 10m;
  }
  

• 执行sudo nginx -s reload生效配置后重新测试。

3. 配置ASP.NET Core请求大小限制 #

ASP.NET Core默认也有请求体长度限制，需手动调整：

• 在Program.cs中全局配置：

  builder.Services.Configure<Microsoft.AspNetCore.Http.Features.FormOptions>(options =>
  {
      options.MultipartBodyLengthLimit = 52428800; // 50M
      options.ValueLengthLimit = 52428800;
  });
  

• 或针对单个控制器/接口添加特性：

  [RequestSizeLimit(52428800)]
  public class CategoryController : ControllerBase
  {
      // 接口逻辑
  }
  

• 重新部署API后测试。

4. 验证Base64字符串合法性 #

• 将触发错误的Base64字符串复制到本地，用Convert.FromBase64String()测试解码是否正常，排除字符串本身格式问题（比如含多余字符、换行符不规范）。
• 若本地解码失败，说明前端传入的Base64格式有误；若本地正常，再排查服务器端是否有字符过滤、编码转换等干预逻辑。

5. 检查服务器资源状态 #

• 执行htop查看CPU、内存使用率，确认处理大Base64字符串时是否出现内存不足导致进程崩溃。
• 用df -h检查磁盘空间，避免因磁盘满导致日志写入失败、临时文件无法创建等问题。

6. 临时添加调试日志定位代码环节 #

在接口方法中添加日志，追踪请求处理流程：

[HttpPost]
public IActionResult CreateCategory([FromBody] CategoryDto dto)
{
    _logger.LogDebug("请求接收：categoryImage长度={Length}", dto.CategoryImage?.Length);
    try
    {
        if (!string.IsNullOrEmpty(dto.CategoryImage))
        {
            var bytes = Convert.FromBase64String(dto.CategoryImage);
            _logger.LogDebug("Base64解码完成，字节数={ByteCount}", bytes.Length);
        }
        // 后续业务逻辑
    }
    catch (Exception ex)
    {
        _logger.LogError(ex, "请求处理失败");
        return StatusCode(500);
    }
}

重新部署后查看日志，确认错误发生在解码环节还是后续业务逻辑。

7. 检查Nginx反向代理配置 #

• 确保Nginx未修改请求体，避免开启proxy_request_buffering off;（可能影响大请求处理）。
• 配置中添加必要的请求头传递：

  proxy_set_header Host $host;
  proxy_set_header X-Real-IP $remote_addr;
  proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
  

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