Alias 用于内部路径映射（地址栏不变），Redirect 用于 HTTP 重定向（地址栏变化）；Alias 必须配合同路径的 Directory 权限配置才生效，且执行早于 RewriteRule，需注意顺序与 PT 标志使用。
mod_alias 的 Redirect 和 Alias 指令根本不是一回事
很多人一上来就用 Redirect，结果发现跳转后浏览器地址栏变了，而实际想做的是内部映射（地址栏不变）。Redirect 是 HTTP 重定向，发 301/302 响应；Alias 才是真正的 URL 到文件系统路径的映射，不改变 URL，也不触发额外请求。
典型误用场景：想把 /static 指向 /var/www/assets，却写了 Redirect /static /var/www/assets —— 这会直接返回 404 或暴露服务器路径，完全错误。
-
Alias用于静态资源路径映射，如前端构建产物、上传目录 -
Redirect仅用于需要用户感知跳转（如旧链接迁移、SEO 重定向） - 两者不能混用同一路径前缀，Apache 会按配置顺序匹配，
Alias匹配成功后不会继续走Redirect
Alias 指令必须配合 Directory 权限控制才生效
只写 Alias /media /srv/uploads 是不够的。Apache 默认禁止访问 DocumentRoot 之外的路径，否则会报 Forbidden: You don't have permission to access this resource。
必须显式声明该路径的访问权限，且 <directory></directory> 块的路径必须和 Alias 后的真实物理路径严格一致（尾部斜杠可选，但建议统一）。
<Directory "/srv/uploads">
Require all granted
Options FollowSymLinks
</Directory>
- 如果用了
FollowSymLinks，确保目标目录所在文件系统允许符号链接，否则加Options +FollowSymLinks无效 - 在 Apache 2.4+ 中，
Allow from all已废弃，必须用Require all granted - 若目标路径在 NFS 或其他网络文件系统上，注意
FollowSymLinks可能被禁用，此时需改用Options SymLinksIfOwnerMatch并确认属主一致
AliasMatch 能处理正则但性能略低，别滥用
AliasMatch 适合动态路径模式，比如把 /img/{year}/{month}/*.jpg 映射到 /storage/images///。但它每次请求都要执行正则匹配，比普通 Alias 多一次 PCRE 解析开销。
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
常见错误是用 AliasMatch ^/api/(.*)$ /opt/backend/$1 试图代理 API —— 这不是反向代理，只是路径拼接，后端服务未必存在对应文件，极易 404。真要转发 API，请用 mod_proxy + ProxyPass。
- 正则中捕获组（
$1,$2）只在AliasMatch右侧可用，Alias不支持 - 避免在
AliasMatch中写过于宽泛的模式，如^/(.*)$，会导致覆盖其他规则或意外匹配 - 调试时开启
LogLevel alias:trace4，可在 error_log 看到匹配过程和最终解析路径
Alias 和 RewriteRule 冲突时，顺序决定一切
如果你同时用了 mod_rewrite，Alias 和 RewriteRule 的执行顺序非常关键：Alias 在 URL-to-filename 阶段早期运行，而 RewriteRule 默认在更晚阶段介入。但一旦启用 RewriteEngine On，且没有明确指定 [PT]（passthrough），rewrite 结果会被重新当作 URL 处理，可能绕过已生效的 Alias。
例如：
Alias /data /var/db/export RewriteRule ^/data/(.*)$ /api/v1/export/$1 [R=302]
这个 rewrite 实际不会触发，因为 /data/xxx 已被 Alias 映射为文件路径，不再进入 rewrite 流程。反过来，如果先 rewrite 成新 URL，再 alias，就得加 [PT]：
RewriteRule ^/legacy/(.*)$ /data/$1 [PT] Alias /data /var/db/export
- 始终把
Alias放在RewriteRule之前，除非你明确需要 rewrite 后再 alias -
[PT]不是万能的，它会让 rewrite 结果跳回 URL-to-filename 阶段，可能再次触发 alias 或其他模块逻辑 - 复杂路由建议优先用
mod_alias做静态映射，动态逻辑交给应用层或mod_proxy，别堆砌 rewrite 规则
Alias 看似简单，但路径拼接、权限控制、模块执行顺序这三处最容易出问题。尤其是跨目录映射时，忘记配 <directory></directory> 或路径写错一个字符，就会静默失败——日志里只有 “File does not exist”，却找不到源头在哪。
