Nginx 中 client_max_body_size 支持在 http、server、location 三级配置，遵循就近覆盖原则；可在不同 location 设置差异化上传限制，需注意兜底值、后端同步配置及正则匹配优先级，并通过 nginx -T 和错误日志验证生效位置。

在 Nginx 中，client_max_body_size 可以在 http、server 和 location 三个层级配置，且遵循“就近覆盖”原则：越靠近请求匹配位置的配置优先级越高。因此，你完全可以在不同 location 块中设置不同的上传大小限制，实现精细化控制。

确保顶层有合理兜底值

建议在 http 或 server 块中设一个安全默认值（如 1m），避免未显式配置的 location 意外接受超大请求：

http {
    client_max_body_size 1m;
    ...
}

在特定 location 中覆盖上传限制

对需要更大上传能力的接口（如文件上传 API、富文本图片插入），在对应 location 内直接设置更高值：

location /api/upload/ {
    client_max_body_size 100m;
    proxy_pass https://www.php.cn/link/65b5b8d1f89bf53a5713bc3afdd83e9e;
}
<p>location /api/avatar/ {
client_max_body_size 5m;
proxy_pass <a href="https://www.php.cn/link/65b5b8d1f89bf53a5713bc3afdd83e9e">https://www.php.cn/link/65b5b8d1f89bf53a5713bc3afdd83e9e</a>;
}</p>

• 注意：该指令只影响当前 location 匹配的请求，不影响其他路径
• 若使用 proxy_pass，后端服务（如 Node.js、Django）自身也需配置对应限制，否则 Nginx 放行后仍可能被后端拒绝

配合正则或前缀匹配灵活控制

支持正则表达式的 location ~ 或前缀匹配均可生效：

location ~ ^/uploads/.*\.(jpg|jpeg|png|pdf)$ {
    client_max_body_size 200m;
}
<p>location /static/ {
client_max_body_size 0; # 禁用上传（不推荐用于静态资源目录，仅作示意）
}</p>

• client_max_body_size 0 表示禁用限制（即无上限），但生产环境慎用
• 正则 location 的优先级低于精确匹配（=）和最长前缀匹配，配置时注意顺序

验证与调试技巧

修改后务必重载 Nginx 并测试实际行为：

• 用 curl -X POST --data-binary @large-file.bin 测试边界值
• 查看错误日志：tail -f /var/log/nginx/error.log，上传超限时会记录 413 Request Entity Too Large
• 确认生效位置：用 nginx -T 输出完整配置，搜索目标 location，核对 client_max_body_size 是否出现在正确层级