#Nginx
共 47 篇文章
Nginx auth_request_set 已有值，limit_req 的 map 键为何仍为空
认证子请求返回档位晚于limit_req执行，解释map空键、首次求值缓存及日志与限流阶段差异。
Nginx real_ip 后日志仍是代理 IP，检查 remote_addr 求值时机
realip规则只在location中生效而remote_addr更早被读取时，日志可能使用旧缓存；检查作用域及原连接地址变量。
Nginx gRPC 报 too large http2 frame，检查 Fabio 的监听协议
gRPC 请求返回502和 too large http2 frame，核对 Nginx 下一跳与 Fabio 的监听端口、协议及RPC路由。
JS 请求返回 text/html，先查 Nginx 实际送回了哪个文件
JS 地址收到首页 HTML，先沿多层代理查真实 URI 和文件，再区分静态资源失败与 SPA 页面回退，保留正确 MIME 和 API 路由。
Nginx 把 alias 改成正则 location 后，文件返回 404
alias 在正则 location 中需要明确完整文件路径；检查捕获结果、实际磁盘路径和其他 location 的匹配次序。
Nginx 返回 STALE 后，上游 429 没有刷新缓存有效期
已有缓存过期后遇到429返回STALE，不会自动续有效期。按保留旧成功对象或缓存错误选择策略，后台更新只合并更新期间请求，不保证固定退避。
Nginx 关闭请求缓冲后，上游仍收到 Content-Length
关闭请求缓冲不保留客户端分块编码。小正文完整预读后可转为Content-Length；按正文完整性和首段到达验收，区分请求方向、版本及业务重试。
Nginx 长查询返回 414：请求行要能放进单个缓冲区
长查询返回 Nginx 414 时，核对请求由哪一层拒绝，以及 large_client_header_buffers 的单个大小。配置位置、默认站点与上游限制都可能影响最终结果。
Nextcloud 上传文件返回 413
Nextcloud 网页或 WebDAV 上传返回 413。通过请求与日志定位限制所在的 Nginx，核对单次请求大小、站点配置及 location 覆盖，备份后调整上限、重载并验证，保留回退步骤。
Cloudflare Flexible 模式下，源站强制 HTTPS 导致重定向循环
HTTPS 地址反复跳转到自身时，检查 Cloudflare 回源模式与源站 HTTP 跳转；按证书条件选择 Full (strict)，或在过渡期调整边缘与源站规则。
Nginx 连接 TCP 后端报 Permission denied：检查 SELinux 拒绝记录
Nginx 连接 TCP 后端报 connect() failed (13: Permission denied)，用同一次请求的 AVC 记录确认 SELinux，核对策略后调整网络连接权限。
Nginx 代理 SSE 后消息成批到达，直到连接结束才显示
SSE 直连及时、经过 Nginx 后积压时，按应用输出、事件分隔和代理响应缓冲逐层定位；只调整事件流端点，并区分请求缓冲与空闲超时。
Certbot HTTP-01 验证收到其他站点的内容
Certbot 验证文件返回另一个网站的 HTML，IPv4 访问却正常。比较有效挑战在 IPv4、IPv6 上的响应，核对 AAAA 和 Nginx 监听及虚拟主机，并用 staging 续期确认修复。
Nginx 把 default.save 备份加载后报 duplicate default server
sites-enabled/* 会把 default.save 等备份一起加载，导致同一地址、端口重复声明默认站点。核对 include 和文件内容，将多余副本移出加载范围，再测试与重载。
Nginx 跨域请求报 Access-Control-Allow-Origin contains multiple values
PHP 或 HTTP 上游与 Nginx 同时添加允许来源头时，浏览器会拒绝跨域响应。确认重复所在的响应，统一策略归属，并按 FastCGI 或 HTTP 转发协议处理上游头。
Docker 挂载配置文件报 not a directory：为什么宿主机多了一个同名目录
配置文件挂载时报 not a directory，核对 Compose 最终路径、源文件类型与容器目标，用 create_host_path: false 阻止误建目录，再重建和验证受影响的服务。
应用页面能打开，WebSocket 经 Nginx 返回 400：检查升级请求头
普通页面能访问，WebSocket 经 Nginx 握手返回 400，检查实际代理位置、Upgrade 与 Connection 透传及头配置继承，再按握手结果验收。
Nginx 多个站点重复 include 后报 duplicate upstream
多个 Nginx 站点重复 include 完整 upstream 块，会触发 duplicate upstream。核对加载入口，在 http 中只定义一次后端组，再由各站点引用。