Apache 的 Alias 指令无法实现前后端路由隔离，必须用 ProxyPass + Location 处理 API 请求，并配合 mod_rewrite 实现 SPA 的前端路由 fallback；Alias 仅支持本地文件系统映射，不可用于代理后端服务。
Apache 的 Alias 指令本身不能实现“同一目录下前后端代码的路由隔离”——因为 Alias 是路径到物理目录的映射，它不处理请求分发逻辑，更不区分前端资源和后端接口。当你的前后端代码打包后都放在同一个文件夹（比如 /var/www/app/），其中既有 index.html、js/ 等静态文件，又有 /api/ 这类需转发给后端服务的路径，此时靠 Alias 单独完成隔离是无效且危险的。
必须用 ProxyPass + Location 排除前端路径
核心思路：把所有以 /api/、/auth/、/v1/ 等为前缀的请求，明确交给后端服务；其余请求默认走静态文件。这需要 Location 块配合 ProxyPass，而不是 Alias：
- 在虚拟主机或主配置中，先定义后端代理规则，优先匹配 API 路径
- 用
<location></location>明确拦截，避免被后续静态规则覆盖 - 确保
ProxyPass和ProxyPassReverse配置完整，保留原始 Host 和路径上下文
示例：
<Location "/api/">
ProxyPass "http://127.0.0.1:8080/api/"
ProxyPassReverse "http://127.0.0.1:8080/api/"
</Location>
<Location "/auth/">
ProxyPass "http://127.0.0.1:8080/auth/"
ProxyPassReverse "http://127.0.0.1:8080/auth/"
</Location>
静态资源仍由 DocumentRoot 托管，但需 fallback 到 index.html
前端是 SPA，所以非 API 请求（如 /user/profile）不能 404，必须返回 index.html，交由 Vue Router 或 React Router 处理。这靠 mod_rewrite 实现，与 Alias 无关：
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
- 启用
mod_rewrite，并在<directory></directory>中配置重写规则 - 先排除真实存在的文件（
!-f）和目录（!-d），再排除已知 API 前缀（如!^/api/） - 最后统一重写为
/index.html，并加[L]终止匹配
示例规则：
RewriteEngine On
RewriteCond %{REQUEST_URI} !^/api/
RewriteCond %{REQUEST_URI} !^/auth/
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ /index.html [L]
别误用 Alias 映射 API 路径
有人试图这样写：Alias /api/ http://localhost:8080/api/ —— 这是错误的。Alias 只能指向本地文件系统路径，不能指向 URL 或后端服务。这种写法会导致 Apache 尝试在磁盘上查找名为 http://localhost:8080/api/ 的目录，直接 500 或 404。
-
Alias仅适用于静态资源路径映射（例如把/static/映射到/opt/cdn/static/） - 涉及协议跳转、服务代理、动态路由的，必须用
ProxyPass、Redirect或RewriteRule - 若强行混用，会破坏请求流向，导致 CORS、路径丢失、Cookie 丢失等问题
额外建议：物理层面也建议分离存放
虽然问题设定是“打包在同一目录”，但从运维和安全角度，不推荐长期这么做：
- 前端静态文件应设为只读（
chmod 444），后端接口脚本/配置需可执行权限，混放易引发权限误配 - 日志、缓存、上传目录等运行时数据应独立于静态资源目录，避免被意外暴露
- 构建流程中可通过 npm script 或 CI 脚本自动将后端 API 文件（如 Swagger JSON、mock 数据）复制到指定子目录，再由
Location单独授权访问
