一、默认值与错误提示
- 默认值：
client_max_body_size 1m;Nginx 默认允许的请求体最大为 1 MiB，超过该值会返回 413 Request Entity Too Large 错误。
错误提示示例：
HTTP/1.1 413 Request Entity Too Large Content-Type: text/html
二、如何配置 client_max_body_size
该指令可放置在 http、server 或 location 块中，后者会覆盖前者的配置：
http {
# 全局设置，作用于所有 server
client_max_body_size 50m;
server {
listen 80;
server_name example.com;
# 针对某个虚拟主机单独设置
client_max_body_size 100m;
location /upload {
# 针对特定路径再度覆盖
client_max_body_size 200m;
proxy_pass http://backend;
}
}
}
说明：在嵌套块中声明的
client_max_body_size会覆盖祖先块中的同名指令。 单位：支持k、m、g（不区分大小写），如10K、2m、1G。
三、client_max_body_size 的最大上限
Nginx 在内部将该值存储为 C 语言类型 off_t，其位宽决定了上限：
- 64 位可执行文件
off_t为 64 位有符号整数，理论最大值为 2⁶³ − 1 字节（约 9.22×10¹⁸ 字节，≈ 8 EiB），故可将client_max_body_size设置至2^63而不报错。
- 32 位可执行文件（未启用大文件支持）
off_t为 32 位有符号整数，其最大值约为 2³¹ − 1（约 2 GiB），即 2147483647 字节。若需突破此限制，可在编译时定义_FILE_OFFSET_BITS=64启用大文件支持，使off_t拓展至 64 位。
四、取消大小检查（无限制上传）
将 client_max_body_size 设置为 0，可禁用对请求体大小的检查，允许无限制上传或 POST 请求：
