RewriteBase显式声明基准路径是解决子目录相对路径错位的核心方法：在子目录.htaccess顶部设RewriteBase /myapp/v2/admin/，使RewriteRule中相对目标自动补全为完整URL路径，避免硬编码绝对路径导致迁移失效。
Apache mod_rewrite 在多层子目录中处理相对路径时，核心问题是 RewriteRule 的匹配起点和重写目标的解析基准不一致——它默认按当前 .htaccess 所在目录做 URI 匹配，但重写后的路径若不含明确前缀，会被 Apache 当作相对于网站根目录解释，导致跳转错位或 404。
用 RewriteBase 显式声明基准路径
这是最直接、最推荐的解法。当项目部署在子目录（如 https://example.com/myapp/v2/admin/）时，必须在该目录下的 .htaccess 顶部声明：
RewriteBase /myapp/v2/admin/- 注意末尾斜杠必须保留，且路径以
/开头，对应 URL 路径而非文件系统路径 - 所有 RewriteRule 中的重写目标（如
index.php或./login.php）都会以此为前缀拼接
避免在规则中硬写绝对路径
错误写法：RewriteRule ^login$ /myapp/v2/admin/login.php [L] —— 这样会强制绑定到根路径，迁移目录即失效。
正确写法：RewriteRule ^login$ login.php [L]，配合上面的 RewriteBase，Apache 自动补全为 /myapp/v2/admin/login.php。
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
若需跳转到上级目录的资源（如共用的 JS 库），可用 ../ 相对引用：RewriteRule ^js/(.*)$ ../shared/js/$1 [L]，前提是目标路径真实存在且权限允许。
区分 RewriteRule 在主配置 vs .htaccess 中的行为
在虚拟主机主配置（<Directory> 块）里写规则时，RewriteRule 的模式匹配的是完整 URI（如 /myapp/v2/admin/login），而 .htaccess 中匹配的是去除前缀后的部分（如 login）。因此：
- 子目录下不要在 .htaccess 里写
^/myapp/...这类带开头斜杠的模式，会永远不匹配 - 若必须跨级跳转（如从
/admin/跳到/api/），优先用完整 URL 重定向：RewriteRule ^api/(.*)$ https://example.com/api/$1 [R=301,L]
验证路径是否被正确解析
开启重写日志可快速定位偏移问题（仅限开发环境）：
- 在主配置中添加：
RewriteLog "/var/log/apache2/rewrite.log"和RewriteLogLevel 3（Apache 2.4+ 改用RewriteEngine On+LogLevel alert rewrite:trace3） - 查看日志中每一步的 URI 输入、条件判断结果、重写后输出，确认
%{REQUEST_URI}和重写目标是否符合预期 - 特别注意
RewriteCond %{REQUEST_FILENAME}的值——它始终是文件系统路径，不受 RewriteBase 影响
