Nginx Alias与WordPress缓存规则冲突导致404问题咨询

这是个很典型的Nginx配置优先级与请求匹配逻辑导致的问题，我来一步步拆解背后的原因：

核心原因：Nginx的Location匹配优先级规则 #

Nginx处理请求时，会按照特定顺序匹配location块，优先级从高到低是：

• 精确匹配（=前缀）
• 前缀匹配（^~前缀）
• 正则匹配（~或~*前缀，区分大小写/不区分）
• 普通前缀匹配（无特殊前缀）

你的冲突大概率出在缓存规则的正则匹配优先级高于Alias的普通前缀匹配：

1. 你的Alias配置应该是类似这样的普通前缀匹配：

   location /images/ {
       alias /actual/path/to/your/images/folder/;
       # 其他配置
   }
   

2. 而适配WordPress的缓存规则，通常是针对静态资源的正则匹配，比如：

   location ~* \.(jpg|jpeg|png|gif|ico)$ {
       expires 30d;
       add_header Cache-Control "public, immutable";
       # 其他缓存相关配置
   }
   

当用户访问example.com/images/photo.jpg时，Nginx会优先匹配正则缓存规则（因为正则匹配优先级高于普通前缀匹配），而这个正则location块里没有设置alias，所以Nginx会默认去你的WordPress站点根目录找/images/photo.jpg，而不是你通过alias指定的实际图片文件夹，自然就返回404了。

另外，WordPress固定链接的核心规则location / { try_files $uri $uri/ /index.php?$args; }是普通前缀匹配，优先级比正则缓存规则低，所以不会直接引发冲突，但缓存规则的“截胡”才是关键。

解决思路 #

你可以通过以下几种方式修复这个冲突：

• 提升Alias的匹配优先级：给Alias的location加上^~前缀，让它的优先级高于正则匹配：

  location ^~ /images/ {
      alias /actual/path/to/your/images/folder/;
      # 这里也可以添加针对图片的缓存规则，避免重复配置
      expires 30d;
      add_header Cache-Control "public, immutable";
  }
  

• 调整缓存正则规则：在正则里排除/images/路径，比如：

  location ~* ^(?!/images/).*\.(jpg|jpeg|png|gif|ico)$ {
      expires 30d;
      add_header Cache-Control "public, immutable";
  }
  

• 整合缓存规则：把静态资源的缓存配置直接放到Alias的location块里，同时保留WordPress其他静态资源的缓存规则，避免重复匹配。

内容的提问来源于stack exchange，提问作者DylanPedro