如何通过 Apache 重写规则实现智能 URL 路由（排除指定路径）

Apache重写规则基础准备

要实现URL重写和智能路由，首先需要确保Apache的mod_rewrite模块已经开启。可以通过在Apache配置文件中查找LoadModule rewrite_module modules/mod_rewrite.so，去掉前面的注释符号开启模块，之后重启Apache服务生效。

重写规则通常写在网站根目录的.htaccess文件中，也可以在Apache的虚拟主机配置文件里配置。如果使用.htaccess文件，需要确认Apache配置中对应目录的AllowOverride设置为All，否则规则不会生效。

智能URL路由的核心逻辑

智能URL路由的目标是将用户访问的看似动态的URL，实际映射到后端的入口文件处理，比如将/article/123映射到index.php?page=article&id=123。核心是先判断请求不是真实存在的文件或目录，再将请求重写到入口文件。

基础的智能路由规则如下：

# 开启重写引擎
RewriteEngine On

# 如果请求的不是真实存在的文件
RewriteCond %{REQUEST_FILENAME} !-f
# 如果请求的不是真实存在的目录
RewriteCond %{REQUEST_FILENAME} !-d
# 将所有请求重写到index.php入口文件
RewriteRule ^(.*)$ index.php [QSA,L]

这里的QSA表示保留原有的查询字符串，L表示当前规则是最后一条生效规则，匹配后不再执行后续规则。

排除指定路径的实现方法

实际开发中，我们通常需要排除静态资源路径（如/static/、/uploads/）、后台管理路径（如/admin/）或者特定接口路径，避免这些路径被重写到入口文件。可以通过添加RewriteCond条件来实现排除。

排除单个指定路径

如果要排除/static/路径下的所有请求，可以添加如下条件：

RewriteEngine On

# 排除/static/路径下的所有请求
RewriteCond %{REQUEST_URI} !^/static/
# 排除真实存在的文件和目录
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
# 重写其他请求到入口文件
RewriteRule ^(.*)$ index.php [QSA,L]

这里的%{REQUEST_URI} !^/static/表示请求的URI不是以/static/开头，满足这个条件才会继续后续的重写判断。

排除多个指定路径

如果需要排除多个路径，比如同时排除/static/、/uploads/和/admin/，可以添加多个排除条件：

RewriteEngine On

# 排除/static/路径
RewriteCond %{REQUEST_URI} !^/static/
# 排除/uploads/路径
RewriteCond %{REQUEST_URI} !^/uploads/
# 排除/admin/路径
RewriteCond %{REQUEST_URI} !^/admin/
# 排除真实存在的文件和目录
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
# 重写其他请求到入口文件
RewriteRule ^(.*)$ index.php [QSA,L]

多个RewriteCond默认是AND关系，只有所有条件都满足时，才会执行后面的RewriteRule。

排除指定文件类型

如果只想排除特定后缀的文件，比如.css、.js、.png等静态文件，也可以通过条件判断实现：

RewriteEngine On

# 排除.css、.js、.png、.jpg、.gif后缀的文件
RewriteCond %{REQUEST_URI} !\.(css|js|png|jpg|gif)$ [NC]
# 排除真实存在的文件和目录
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
# 重写其他请求到入口文件
RewriteRule ^(.*)$ index.php [QSA,L]

这里的[NC]表示不区分大小写，避免用户请求.CSS这类大写后缀的文件时被错误重写。

完整配置示例与验证

以下是一个包含多路径排除的完整.htaccess配置示例，适配大多数网站的路由需求：

# 开启重写引擎
RewriteEngine On

# 排除静态资源路径
RewriteCond %{REQUEST_URI} !^/static/
RewriteCond %{REQUEST_URI} !^/uploads/
# 排除后台管理路径
RewriteCond %{REQUEST_URI} !^/admin/
# 排除特定文件类型
RewriteCond %{REQUEST_URI} !\.(css|js|png|jpg|gif|ico|svg)$ [NC]
# 排除真实存在的文件和目录
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
# 重写到入口文件，传递原始请求路径作为参数
RewriteRule ^(.*)$ index.php?url=$1 [QSA,L]

配置完成后，可以通过访问不同路径验证规则是否生效：访问/static/style.css应该直接返回文件内容，访问/article/123应该被重写到index.php?url=article/123，访问/admin/login不会被重写，直接走对应的真实路径。

常见问题排查

• 如果规则不生效，先检查mod_rewrite模块是否开启，AllowOverride是否设置为All。
• 排除路径的规则要放在重写规则之前，否则会先执行重写，排除条件不生效。
• 如果路径排除后仍然被重写，检查路径前缀是否正确，比如是否漏写了开头的/。
• 可以通过在.htaccess中添加RewriteLog "/var/log/apache2/rewrite.log"（Apache 2.2版本）或者LogLevel alert rewrite:trace6（Apache 2.4版本）查看重写日志，排查规则匹配问题。

ApacheURL_重写mod_rewrite路由规则路径排除修改时间：2026-05-30 23:23:41