Apache中Alias与ProxyPass配合实现前后端分离的核心是：先用ProxyPass精准拦截/api/等动态路径并转发至后端，再用Alias挂载前端静态资源根目录，且ProxyPass必须置于Alias之前以避免覆盖，同时需启用proxy相关模块并处理前端路由fallback。
Apache 中用 Alias 配合 ProxyPass 实现前后端分离目录代理，核心在于：让静态资源（如前端 HTML、JS、CSS）走本地文件系统路径，而 API 请求（如 /api/）反向代理到后端服务。两者不能冲突，关键在匹配顺序和路径排除。
明确职责分工：Alias 管静态，ProxyPass 管动态
Alias 用于将 URL 路径映射到服务器本地目录（比如把 / 映射到 /var/www/myapp/dist），适合托管前端打包后的静态文件；ProxyPass 则把特定路径（如 /api/）转发给后端服务（如 http://localhost:8080/api/）。必须确保 ProxyPass 规则优先于 Alias 对应的路径匹配，否则请求可能被静态文件拦截，导致 API 调用 404。
FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。
配置顺序很重要：ProxyPass 必须放在 Alias 前面
Apache 按配置出现顺序匹配，先写的规则优先生效。因此要让 /api/ 这类请求先被 ProxyPass 拦截，再让根路径 / 由 Alias 处理剩余请求。典型配置如下：
<VirtualHost *:80>
ServerName example.com
# ✅ 先定义代理：/api/ 及子路径全部转给后端
ProxyPass /api/ http://127.0.0.1:8080/api/
ProxyPassReverse /api/ http://127.0.0.1:8080/api/
# ✅ 再挂载前端静态资源（注意：不覆盖 /api/）
Alias / /var/www/myapp/dist/
<Directory "/var/www/myapp/dist">
Require all granted
</Directory>
# ⚠️ 关键：禁止 /api/ 被 Alias 处理（可选但推荐）
<Location "/api/">
Require all denied
</Location>
</VirtualHost>
常见陷阱与绕过技巧
-
别让 Alias 覆盖了 ProxyPass 路径：如果写成
Alias / /path，所有请求（包括/api/login）都会尝试从磁盘找文件。务必确认ProxyPass在前，且路径精确（末尾斜杠影响匹配） -
启用 proxy 和 rewrite 模块：运行
a2enmod proxy proxy_http proxy_html，否则ProxyPass不生效 -
前端路由（如 Vue Router history 模式）需 fallback：用户直接访问
/user/123会 404，因为 Apache 找不到该路径的静态文件。加一条重写规则：RewriteEngine On<br> RewriteCond %{REQUEST_FILENAME} !-f<br> RewriteCond %{REQUEST_FILENAME} !-d<br> RewriteRule ^(.*)$ /index.html [L] -
避免重复代理：若后端已处理
/api/，就不要对/做全局ProxyPass，否则前端资源也全被转发，失去静态托管意义
验证是否生效的小方法
重启 Apache 后，可以这样快速验证：
- 访问
http://your-domain.com/api/test→ 应返回后端响应（不是 404 或静态页） - 访问
http://your-domain.com/→ 应加载前端首页（检查 Network 面板，JS/CSS 加载路径为 200） - 访问一个不存在的前端路由（如
/xyz）→ 应仍显示首页（history 模式 fallback 生效） - 查看 Apache 错误日志：
tail -f /var/log/apache2/error.log，留意 proxy 或 alias 相关报错
