Laravel中.htaccess的RewriteRule不生效问题排查

兄弟，我来帮你排查下这个问题——你遇到的情况在Laravel+Apache的环境里挺常见的，咱们一步步拆解可能的原因：

1. 规则顺序放错了（最常见原因） #

Apache的RewriteRule是从上到下按顺序匹配的，而且Laravel默认的.htaccess最后会有一条把所有请求转发到index.php的规则：

RewriteRule ^ index.php [L]

这里的[L]标记是「Last」的意思，一旦匹配到这条规则，后续所有规则都会被跳过。如果你把自定义的RewriteRule放在这条规则之后，那它根本不会被执行！

解决办法：把你的自定义规则移动到这条默认转发规则的前面，确保Apache先处理你的规则，再走Laravel的路由转发。

2. 物理目录存在导致Apache优先处理 #

如果你的public目录下真的存在resources/pdf/这个实际的物理目录，Apache的mod_dir模块会优先处理这个目录请求（比如自动补全斜杠、返回目录列表），完全跳过你的RewriteRule。

解决办法：

• 如果你想强制用RewriteRule处理这个目录的请求，可以在规则前加条件排除物理目录：

  # 只有当请求的不是实际存在的目录时才执行你的规则
  RewriteCond %{REQUEST_FILENAME} !-d
  RewriteRule ^resources/pdf/(.*)$ 你的目标路径 [L,R=301]
  

• 或者关闭Apache的自动目录补全（不推荐，可能影响其他功能）：

  DirectorySlash Off
  

3. 正则表达式匹配错误 #

检查你的RewriteRule的正则是否正确，比如要匹配/resources/pdf/开头的所有请求，正则应该写成^resources/pdf/(.*)$（注意开头没有斜杠，因为Apache的RewriteRule匹配的是去掉域名和RewriteBase后的路径）。如果正则写得不对，自然匹配不到请求。

举个正确的示例：

# 把/resources/pdf/xxx转发到/storage/pdf/xxx
RewriteRule ^resources/pdf/(.*)$ storage/pdf/$1 [L]

4. Laravel路由冲突 #

如果你的Laravel路由文件里已经定义了/resources/pdf/相关的路由，而且你的.htaccess规则没有优先匹配，请求会先被Laravel路由捕获，返回404或错误页面。这时候需要确保.htaccess的规则在Laravel路由之前生效（也就是把规则放在默认的index.php转发规则前面）。

5. RewriteBase配置问题 #

虽然你的/about能正常访问，但如果RewriteBase配置错误也可能影响规则。确保你的.htaccess开头有正确的配置：

RewriteEngine On
RewriteBase /

如果你的Laravel部署在子目录，RewriteBase要改成对应的子路径，但根目录的话保持/就好。

你可以先检查最常见的「规则顺序」问题，调整后再测试，应该能解决大部分情况。

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