在网站开发中，经常会遇到需要让同一个URL路径根据请求特征返回不同类型内容的需求，比如同一个/api/data路径，普通浏览器访问返回HTML页面，接口调用返回JSON数据，第三方请求返回XML格式。这时候使用.htaccess的高级URL重写功能就能很好地实现这个需求，还能保持URL的整洁统一。
前置条件准备
首先要确保服务器环境满足以下条件：
- 服务器使用Apache作为Web服务软件
- 已经开启mod_rewrite模块，可通过在.htaccess中添加
RewriteEngine_On测试是否生效 - 网站根目录允许使用.htaccess覆盖配置，即Apache配置中对应目录的AllowOverride设置为All
核心重写规则基础
所有重写规则都需要先开启重写引擎，基础格式如下：
# 开启重写引擎 RewriteEngine On # 设置重写基础路径，避免相对路径问题 RewriteBase /
判断请求特征常用的条件指令有：
RewriteCond：设置重写的前置条件，只有条件满足才会执行后续重写规则%{HTTP_ACCEPT}：获取请求头中的Accept字段，可判断客户端期望接收的内容类型%{QUERY_STRING}：获取请求的查询参数，可通过参数区分内容类型%{REQUEST_URI}：获取当前请求的URI路径
多场景实现示例
根据Accept请求头分发内容
这种场景适合接口类请求，通过客户端发送的Accept头判断返回类型：
# 如果请求Accept包含application/json，重写到JSON处理脚本
RewriteCond %{HTTP_ACCEPT} application/json
RewriteRule ^api/data$ /api/handle.php?type=json [L]
# 如果请求Accept包含application/xml，重写到XML处理脚本
RewriteCond %{HTTP_ACCEPT} application/xml
RewriteRule ^api/data$ /api/handle.php?type=xml [L]
# 其他情况默认重写到HTML页面
RewriteRule ^api/data$ /api/data.html [L]根据查询参数分发内容
如果客户端不方便设置请求头，也可以通过查询参数区分：
# 如果请求参数type为json，重写到JSON处理
RewriteCond %{QUERY_STRING} (^|&)type=json(&|$)
RewriteRule ^api/data$ /api/handle.php?format=json [L]
# 如果请求参数type为xml，重写到XML处理
RewriteCond %{QUERY_STRING} (^|&)type=xml(&|$)
RewriteRule ^api/data$ /api/handle.php?format=xml [L]根据路径后缀隐藏分发
可以对外暴露统一路径，内部根据规则转发到不同后缀的处理文件：
# 请求/api/data，实际根据内部判断转发
# 先判断是否存在对应的json处理文件
RewriteCond %{DOCUMENT_ROOT}/api/data.json -f
RewriteRule ^api/data$ /api/data.json [L]
# 再判断是否存在对应的xml处理文件
RewriteCond %{DOCUMENT_ROOT}/api/data.xml -f
RewriteRule ^api/data$ /api/data.xml [L]
# 都不存在则返回默认HTML
RewriteRule ^api/data$ /api/data.html [L]规则调试与注意事项
在编写规则时可能会遇到不生效的问题，可通过以下方式调试：
- 在.htaccess中添加
RewriteLog "/tmp/rewrite.log"和RewriteLogLevel 3（注意Apache 2.4+日志指令有变化，需用LogLevel alert rewrite:trace3）查看重写过程 - 规则末尾的
[L]表示当前规则匹配后停止后续规则匹配，注意不要遗漏导致规则重复执行 - 正则表达式中的特殊字符需要转义，比如
.要写成\.，避免匹配错误 - 重写后的路径要确保对应的文件或脚本存在，否则会出现404错误
通过合理的.htaccess重写规则配置，就能在不改变对外URL格式的前提下，灵活实现同一路径服务多类型内容的需求，既提升了用户体验，也方便后续的接口扩展和维护。
htaccessURL重写mod_rewrite多类型内容重定向规则修改时间：2026-05-25 16:39:37