常见 HTTP 状态码详解与Nginx 文件上传大小限制

在我们日常使用 Nginx 搭建网站或应用服务时，可能会遇到很多与文件上传和请求响应相关的问题。今天我们就来聊聊 如何限制文件上传的大小，并介绍一些常见的 HTTP 状态码 及其在 Nginx 中的处理方式。

一、文件上传大小限制

有时，我们需要限制用户上传文件的大小，以防止上传过大的文件占用服务器资源。在 Nginx 中，可以通过 client_max_body_size 指令轻松实现这一目的。该指令用于限制 HTTP 请求体的最大大小，也就是用户上传的文件大小。

配置方法

你可以将该指令放在不同的配置块中，决定其作用范围。

• 全局限制（针对所有请求）：

  http {
      client_max_body_size 50M;  # 限制请求体最大为 50M
      ...
  }
  

• 针对某个虚拟主机的限制：

  server {
      listen 80;
      server_name example.com;
  
      client_max_body_size 50M;  # 针对 example.com 限制最大上传为 50M
  
      location / {
          ...
      }
  }
  

• 针对特定路径的限制：

  server {
      listen 80;
      server_name example.com;
  
      location /upload {
          client_max_body_size 100M;  # 仅针对 /upload 路径限制最大上传为 100M
      }
  }
  

413 Request Entity Too Large 错误

如果上传的文件超过了我们设置的限制，Nginx 会返回 413 Request Entity Too Large 错误。我们可以为这个错误配置自定义的页面：

server {
    error_page 413 /custom_413.html;
    location = /custom_413.html {
        root /usr/share/nginx/html;
    }
}

配置生效

配置完成后，我们需要进行以下操作，使更改生效：

1. 测试配置文件是否正确：

   sudo nginx -t
   

2. 重新加载 Nginx 配置：

   sudo systemctl reload nginx
   

二、常见 HTTP 状态码详解

HTTP 状态码是服务器返回给客户端的重要信息，用于指示请求的处理结果。不同状态码代表不同的请求结果，下面列出一些常见的状态码及其在 Nginx 中的处理方式。

1. 200 OK

• 解释：请求成功，服务器正常返回了资源。
• Nginx：无需特别配置，默认返回。

2. 301 Moved Permanently

• 解释：请求的资源已永久移动到新的位置。
• Nginx 配置：

  server {
      listen 80;
      server_name example.com;
      return 301 https://newdomain.com$request_uri;
  }
  

3. 302 Found

• 解释：资源暂时移动，客户端可以继续使用原 URL 进行请求。
• Nginx 配置：

  server {
      listen 80;
      server_name example.com;
      return 302 https://newdomain.com$request_uri;
  }
  

4. 403 Forbidden

• 解释：服务器拒绝处理请求，可能是因为没有权限访问资源。
• Nginx 配置：

  server {
      location /restricted {
          deny all;
      }
  }
  

5. 404 Not Found

• 解释：服务器无法找到请求的资源，通常是因为资源已删除或不存在。
• Nginx 配置：

  server {
      location / {
          try_files $uri $uri/ =404;
      }
  }
  

6. 422 Unprocessable Entity

• 解释：服务器理解请求内容，但由于请求数据有误，无法处理请求。通常在验证失败时使用。
• Nginx 配置：

  server {
      error_page 422 /custom_422.html;
      location = /custom_422.html {
          root /usr/share/nginx/html;
      }
  }
  

7. 500 Internal Server Error

• 解释：服务器内部错误，无法处理请求，通常是服务器端程序出现问题。
• Nginx 配置：

  server {
      error_page 500 502 503 504 /50x.html;
      location = /50x.html {
          root /usr/share/nginx/html;
      }
  }
  

8. 502 Bad Gateway

• 解释：服务器作为网关或代理，接收到无效的响应，通常发生在后端服务有问题时。
• Nginx 配置：

  server {
      error_page 502 /custom_502.html;
      location = /custom_502.html {
          root /usr/share/nginx/html;
      }
  }
  

9. 503 Service Unavailable

• 解释：服务器暂时无法处理请求，可能是因为维护或负载过高。
• Nginx 配置：

  server {
      error_page 503 /custom_503.html;
      location = /custom_503.html {
          root /usr/share/nginx/html;
      }
      location / {
          if ($maintenance) {
              return 503;
          }
      }
  }
  

三、总结

Nginx 是强大且灵活的服务器，能够通过配置文件轻松控制上传文件大小，并为各种 HTTP 状态码提供自定义的响应页面。在实际项目中，根据需要合理配置 Nginx 的行为，既可以提高安全性，又能提升用户体验。