如何解决Azure App Service PHP页面上传文件时413错误？

问题描述 在使用 Azure App Service（Linux + PHP） 部署 Web 应用时，如果上传文件大于1MB，就会遇到 HTTP 413（Request Entity Too Large） 错误。 错误截图 问题解答 一、HTTP 413 错误的本质含义 413 Request Entity Too Large 是标准 HTTP 状态码，表示： 客户端提交的请求体（Request Body）大小超过了服务器当前允许的最大限制。 在 Azure App Service（Linux）环境中，这个错误并不一定来自前端网关(Frontend)，而更常见的来源是 App Service 容器内部的 Web Server（如 Nginx）或运行时（如 PHP）。 二、Nginx 默认的 client_max_body_size 限制 在 Linux App Service 中，平台内置 Nginx 作为 Web Server。 Nginx 会在请求到达应用之前，对请求体大小进行校验。 当上传文件大小超过 Nginx 允许的最大值时(Nginx 对上传请求体大小的默认限制为 1 MB，需要通过 client_max_body_size 参数修改大小) Nginx 会直接返回 413, 请求不会进入 PHP 如果未显式配置，该值通常较小，不适合文件上传场景。通过自定义 Nginx 配置，将其调整为更大的值（例如 20MB），即可解除这一层限制。 解决方案 修改 App Service默认Nginx的client_max_body_size参数 第一步：把App Service默认的Nginx配置复制到home/site/wwwroot目录中 进入kudu，选择SSH到Application, 执行cp命令 cp /etc/nginx/sites-available/default /home/site/wwwroot/default 操作截图： 第二步：添加client_max_body_size参数并设置为20M 在Kudu页面的File Manager中，进入home/site/wwwroot目录中，选择default文件，直接UI上添加（client_max_body_size 20M;）后保存。 操作截图： 第三步：覆盖nginx default配置并重启 因修改了默认的nginx配置，为了使得配置生效，需要用新的配置文件覆盖默认配置，并重启nginx服务。使用如下命令： cp /home/site/wwwroot/default /etc/nginx/sites-available/default && service nginx reload 此命令将默认 NGINX 配置文件替换为存储库根目录中命名 default 的文件，并重新启动 NGINX。 操作截图 结论 完成以上三步之后，刷新php应用的上传页面，再次上传小于20MB的文件，成功。 参考资料 Azure App Service（Linux）自定义 Nginx 配置 https://learn.microsoft.com/azure/app-service/configure-language-php?pivots=platform-linux#change-the-site-root Nginx 官方文档：client_max_body_size https://nginx.org/en/docs/http/ngx_http_core_module.html#client_max_body_size Syntax: client_max_body_size size; Default: client_max_body_size 1m; Context: http, server, location Sets the maximum allowed size of the client request body. If the size in a request exceeds the configured value, the 413 (Request Entity Too Large) error is returned to the client. Please be aware that browsers cannot correctly display this error. Setting size to 0 disables checking of client request body size.