apache url重写核心依赖mod_rewrite模块和allowoverride all配置，通过rewriterule实现301/302跳转、目录映射及qsa参数保留，需注意正则末尾$、路径斜杠位置及rewriteengine开启等关键细节。
Apache URL 重写是网站重构中实现平滑跳转的核心手段，关键在于用 .htaccess 或主配置文件精准控制请求路径映射，既保障用户访问不中断，又让搜索引擎正确识别新旧关系。
确认启用 rewrite 模块
重写功能依赖 mod_rewrite 模块。Linux 下执行：
-
a2enmod rewrite（Debian/Ubuntu） - 或检查
httpd.conf中是否含LoadModule rewrite_module modules/mod_rewrite.so - 确保虚拟主机配置中设置了
AllowOverride All，否则.htaccess不生效
用 RewriteRule 实现不同跳转类型
根据重构目标选择状态码和规则写法：
Apache Superset Dashboard and SQL Exploration Skill
下载
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
- 整站永久迁移（如 oldsite.com → newsite.com）：
RewriteRule ^(.*)$ https://newsite.com/$1 [R=301,L] - 单页替换（如 /old-page.html → /new-section/intro.html）：
RewriteRule ^old-page\.html$ /new-section/intro.html [R=301,L] - 目录结构调整（如 /blog/xxx → /articles/xxx）：
RewriteRule ^blog/(.*)$ /articles/$1 [R=301,L] - 保留查询参数（?id=123）需加
QSA标志：RewriteRule ^product\.php$ /shop/item.php [R=301,QSA,L]
避免常见陷阱
看似简单，但几处细节极易出错：
- 正则表达式末尾未加
$可能误匹配，比如^old会同时匹配/old和/old-news - 使用
R=302测试期间务必改成R=301上线，否则搜索引擎不会传递权重 - 开启
RewriteEngine On是前提，否则所有规则静默失效 - 路径开头的斜杠：在
.htaccess中规则匹配的是去除 DocumentRoot 后的相对路径，不写开头/；在主配置中则要写全路径
验证与调试
上线前必须验证效果：
- 用
curl -I http://yoursite/old-url查看返回头，确认含HTTP/1.1 301 Moved Permanently和正确的Location - 检查浏览器地址栏是否跳转、是否带多余参数、是否形成循环（如 A→B→A）
- 查看 Apache 错误日志（
ErrorLog配置项指定路径），定位语法错误或匹配异常
