.htaccess配置：解决路径参数与文件夹同名时带参重定向到index.html失效问题

现有配置的判断逻辑为：只要请求路径对应服务器上真实存在的文件或者目录，就直接停止重写、返回对应资源，不会进入后续将请求转发到index.html的流程。当路由参数值和部署目录下的文件夹同名时，请求会直接命中“存在目录”的判断规则，返回目录内容，打断单页应用的路由参数传递流程。

要解决该冲突，需要调整资源放行的判断优先级：

• 所有请求路径对应真实存在的静态文件时，正常直接返回对应资源，不阻断静态资源加载
• 所有指向目录的请求（哪怕目录真实存在），一律不直接返回目录内容，强制走路由转发逻辑，将路径参数传递给入口index.html

<IfModule mod_rewrite.c>
  RewriteEngine On
  # 关闭目录请求自动补斜杠的默认行为，避免干扰路由判断
  DirectorySlash Off

  # 仅当请求路径对应真实存在的文件时，直接返回该资源
  RewriteCond %{DOCUMENT_ROOT}%{REQUEST_URI} -f
  RewriteRule ^.*$ - [NC,L]

  # 其余所有请求（含匹配到同名目录的路由请求），统一转发到站点入口index.html
  RewriteRule ^(.*) index.html [NC,L]
</IfModule>

• 移除了原配置中判断“路径是真实目录即直接放行”的RewriteCond %{DOCUMENT_ROOT}%{REQUEST_URI} -d规则，从根源上避免同名目录抢占路由响应
• 保留了真实文件的匹配规则，部署目录下的图片、脚本、样式、文档类静态资源，只要请求路径和文件路径完全匹配，依然会正常返回，不会出现静态资源加载失败的问题
• 当用户访问http://my_website/apple这类带路由参数的地址时，哪怕站点根目录下存在名为apple的文件夹，因为请求没有指向文件夹内的具体实体文件，就会命中路由转发规则，将apple作为参数正常传递给入口的index.html
• 后续如果需要对某个特殊目录开放直接访问权限，只需要在对应目录放置独立的.htaccess配置，单独开启资源放行规则即可，不会影响全局的路由逻辑

内容的提问来源于stack exchange，提问作者Kenneth Chan