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

news2024/9/21 17:57:46

在我们日常使用 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;
    }
}

配置生效

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

测试配置文件是否正确：
```
sudo nginx -t
```
重新加载 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;
        }
    }
}