本文详解如何通过 .htaccess 实现：访问根路径 / 时自动加载 template/index.html，同时将 /api/ 开头的请求精准转发至 api.php，避免规则冲突、路径误匹配及目录列表暴露问题。
本文详解如何通过 `.htaccess` 实现：访问根路径 `/` 时自动加载 `template/index.html`，同时将 `/api/` 开头的请求精准转发至 `api.php`，避免规则冲突、路径误匹配及目录列表暴露问题。
在 Apache 的 URL 重写实践中，一个常见却易错的需求是：根路径（/）返回前端入口页（如 template/index.html），而所有 /api/ 子路径统一交由 api.php 处理。但若规则顺序不当、正则不严谨或忽略服务器变量特性（如 REQUEST_URI 恒以 / 开头），极易导致重写失效、目录索引暴露，甚至根路径被错误捕获进 API 路由。
✅ 正确的根路径重写规则
原始尝试中使用了：
RewriteCond %{REQUEST_URI} ^$
RewriteRule . template/index.html [QSA]该写法存在两个根本性错误：
- RewriteCond %{REQUEST_URI} ^$ 永远为假 —— 因为 REQUEST_URI 值恒为 /（而非空字符串），故条件永不成立；
- RewriteRule . 中的 . 匹配任意单个非换行字符，无法匹配空路径；且即使匹配成功，也缺乏终止标记，易被后续规则覆盖。
✅ 正确写法仅需一行，简洁且语义明确：
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
RewriteRule ^$ template/index.html [L]
- ^$ 精准匹配空路径（即根 URI /）；
- [L] 标志确保匹配后立即终止重写流程，防止被后续规则干扰；
- 无需 RewriteCond，因为 ^$ 本身已具备唯一性。
✅ API 路由应精准限定范围
原规则 RewriteRule ^(.*)$ api.php [QSA] 过于宽泛：它会捕获所有非静态资源请求（包括 /, /css/app.css, /robots.txt），不仅低效，更可能掩盖真实问题（如静态文件缺失时误入 API）。结合题干示例 /api/someendpoint，应改为前缀匹配：
RewriteRule ^api/(.*)$ api.php?path=$1 [QSA,L]
- ^api/(.*)$ 仅匹配以 /api/ 开头的路径；
- 将子路径（如 someendpoint）作为 path 参数传递给 api.php，便于后端路由解析；
- [L] 同样关键，确保 API 请求不再继续执行其他规则。
⚠️ 注意：若启用 MultiViews（Apache 默认可能开启），当请求 /api/xxx 时，服务器可能尝试匹配 api.php 文件名并自动协商，导致重写失效。务必在 .htaccess 顶部显式禁用：
Options -MultiViews
✅ 完整推荐配置（.htaccess）
# 禁用 MultiViews 防止内容协商干扰重写
Options -MultiViews
# 启用重写引擎
RewriteEngine On
# 【优先】根路径 → template/index.html
RewriteRule ^$ template/index.html [L]
# 【其次】/api/ 开头的请求 → api.php，并透传子路径
RewriteRule ^api/(.*)$ api.php?path=$1 [QSA,L]
# 【兜底】静态文件存在则直接提供；否则交由前端路由（可选）
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ index.html [QSA,L]? 关键注意事项总结
- 规则顺序即执行优先级：^$ 和 ^api/ 规则必须置于通用兜底规则之前，否则会被提前捕获；
- [L] 不等于 [END]：[L] 仅终止当前轮次重写，若存在多轮处理仍可能再匹配；对根和 API 这类确定性路由，[L] 已足够；
-
调试技巧：启用 Apache 重写日志（需管理员权限）：
LogLevel alert rewrite:trace3
可清晰追踪每条规则的匹配与跳转过程；
-
安全补充：建议在 template/ 目录下放置 .htaccess 阻止 PHP 执行（防模板注入）：
<Files "*.html"> Require all granted </Files> <Files "*.php"> Require all denied </Files>
通过以上配置，即可实现语义清晰、性能可控、安全可靠的前后端分离路由——根路径优雅呈现前端页面，API 请求精准抵达服务层，彻底告别目录列表暴露与规则“静默失效”问题。
