当前位置：首页 > news >正文

【Nginx系列】Nginx配置优先级

news 来源：原创 2025/7/15 6:34:39

💝💝💝欢迎来到我的博客，很高兴能够在这里和您见面！希望您在这里可以感受到一份轻松愉快的氛围，不仅可以获得有趣的内容和知识，也可以畅所欲言、分享您的想法和见解。

推荐:kwan 的首页,持续学习,不断总结,共同进步,活到老学到老
导航
檀越剑指大厂系列:全面总结 java 核心技术,jvm,并发编程 redis,kafka,Spring,微服务等
常用开发工具系列:常用的开发工具,IDEA,Mac,Alfred,Git,typora 等
数据库系列:详细总结了常用数据库 mysql 技术点,以及工作中遇到的 mysql 问题等
新空间代码工作室:提供各种软件服务,承接各种毕业设计,毕业论文等
懒人运维系列:总结好用的命令,解放双手不香吗?能用一个命令完成绝不用两个操作
数据结构与算法系列:总结数据结构和算法,不同类型针对性训练,提升编程思维,剑指大厂

非常期待和您一起在这个小小的网络世界里共同探索、学习和成长。💝💝💝 ✨✨ 欢迎订阅本专栏 ✨✨

博客目录

- 问题描述
- 原因分析
- 解决方案
- - 修正后的 Nginx 配置
  - 关键调整
- 进一步检查
- 结论

在现代互联网架构中，Nginx 以其高性能、高稳定性和丰富的功能集成为了最受欢迎的 Web 服务器之一。然而，即使是一款强大的工具，也需要正确的配置才能发挥其最大效能。

问题描述

在实际部署中，我们可能会遇到 Nginx 无法正确服务静态资源的问题。例如，当 Nginx 尝试从/data/cicd/new-space/kwan/路径下查找图片资源（如202411262137475.png）时，却返回了 404 错误。这通常意味着 Nginx 的配置没有按预期生效，导致请求没有被正确处理。
在这里插入图片描述

原因分析

通过对问题进行深入分析，我们可以发现两个主要原因：

location 指令优先级未正确配置：请求路径/new-space/kwan/202411262137475.png被正则匹配location ~ .*\.(gif|jpg|jpeg|png|jfif|webp)$捕获，导致静态资源路径/data/cicd/new-space/kwan/被使用，而非代理转发。
静态文件路径配置冲突：静态文件配置root /data/cicd/;应用于了/new-space/kwan/目录的子路径，但期望的是代理策略优先处理/new-space/kwan/。

解决方案

为了确保/new-space/kwan/的代理策略优先生效，我们需要调整 Nginx 配置，以避免静态文件匹配规则干扰代理路径。

修正后的 Nginx 配置

以下是修正后的 Nginx 配置示例：

# 优先匹配代理路径
location ^~ /new-space/kwan/ {proxy_pass http://43.139.90.182:9000/new-space/kwan/;proxy_set_header Host $host;proxy_set_header X-Real-IP $remote_addr;proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;proxy_set_header X-Forwarded-Proto $scheme;
}# 静态文件匹配，避免影响代理
location ~ .*\.(gif|jpg|jpeg|png|jfif|webp)$ {root /data/cicd/;autoindex on;
}

关键调整

使用^~修饰符：在/new-space/kwan/前缀匹配中加^~，明确指示 Nginx 优先使用该规则，避免被正则匹配规则干扰。
代理路径独立处理：/new-space/kwan/及其子路径将完全由代理处理。
静态文件独立路径：静态文件规则仍保留，但不会影响/new-space/kwan/的代理策略。

进一步检查

如果问题仍未解决，可以进行以下检查：

检查其他 location 规则：确认 Nginx 没有其他location规则可能影响该路径。
检查代理服务器资源：确认/new-space/kwan/子路径的资源在代理服务器是否正确提供。
检查静态资源目录：确认/data/cicd/目录是否存在图片资源。

结论

通过上述分析和调整，我们可以有效地解决 Nginx 在处理静态资源时返回 404 错误的问题。正确的配置和对 Nginx 工作原理的理解是确保 Web 服务器高效运行的关键。在面对配置问题时，我们应该从优先级、路径冲突等角度进行分析，并结合实际的服务器环境进行调整。通过这种方式，我们可以确保 Nginx 能够正确地处理请求，提供稳定且高效的服务。

觉得有用的话点个赞 👍🏻 呗。
❤️❤️❤️本人水平有限，如有纰漏，欢迎各位大佬评论批评指正！😄😄😄

💘💘💘如果觉得这篇文对你有帮助的话，也请给个点赞、收藏下吧，非常感谢!👍 👍 👍

🔥🔥🔥Stay Hungry Stay Foolish 道阻且长,行则将至,让我们一起加油吧！🌙🌙🌙