Alias 不适合平滑迁移，因其仅支持静态路径映射，无法转发请求、分流、透传 Header 或处理响应头；应改用 mod_proxy + mod_rewrite 实现智能代理与灰度分发。
Alias 本身不支持动态路由或条件转发，不能直接用于“平滑迁移”场景；它只是静态路径映射，适合将某个 URL 路径固定指向本地文件系统目录。要实现旧版到新版的过渡期访问，关键不是用 Alias 做代理，而是用 mod_proxy + mod_rewrite 实现请求接管与智能分发。
为什么 Alias 不适合平滑迁移
Alias 只做本地路径别名，例如：
Alias /old-app "/var/www/legacy"
它把 /old-app/* 映射到服务器本地目录，无法：
- 把请求转发到另一个后端服务（如 http://new-api:8080）
- 根据 Header、Cookie 或路径特征分流
- 透传 Authorization、JWT 等关键头
- 自动处理响应头中的重定向 Location 或 Set-Cookie 路径
真正可用的过渡方案：用 Proxy + Rewrite 替代 Alias
把原来想用 Alias 绑定的路径，改为由 Apache 接管并按规则代理：
- 保留客户端调用不变（仍访问
/old-app/users） - Apache 内部识别该路径，转发给新版服务（如
http://new-svc/api/v2/users） - 同时支持灰度、降级、Header 透传等迁移必需能力
示例配置（放在 <VirtualHost> 内）：
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
ProxyPreserveHost On
ProxyAddHeaders Off
RequestHeader set Authorization "%{HTTP:Authorization}s"
# 将 /old-app/ 下所有请求代理到新服务，并重写路径前缀
RewriteRule ^/old-app/(.*)$ http://new-svc:8080/api/v2/$1 [P,L]
# 自动修正响应头中的重定向和 Cookie 路径
ProxyPassReverse /old-app/ http://new-svc:8080/api/v2/
过渡期必备增强能力
仅转发还不够，真实迁移需要这些配套机制：
-
灰度控制：用
RewriteCond按请求头或 Cookie 分流，例如只让X-Release-Phase: canary的请求走新版 -
故障兜底：新版不可用时，自动切回旧版或返回兼容响应（需配合
ProxyBadHeader Ignore和自定义 ErrorDocument） -
可观测提示：对旧路径响应添加
Header set X-API-Migrated "true"，提醒客户端逐步切换 -
日志标记：在 access log 中记录
%{X-Forwarded-For}i %U %{VHOST}e %{backend}e，区分新旧后端流量
如果必须保留 Alias 风格的静态资源访问
某些前端资源（如 JS/CSS/图片）可继续用 Alias，但建议搭配 <Location> 做细粒度控制：
Alias /static/v1 "/var/www/legacy/static"
<Location "/static/v1">
Require all granted
Header set Cache-Control "public, max-age=31536000"
</Location>
而动态 API 路径一律交给 RewriteRule [P] 处理，不混用。
