GitHub Pages无法正确返回Angular Universal预渲染带参数页面

我通过GitHub Pages部署预渲染Web应用，已在本地完成全部内容预渲染并提交至hosted-demo分支。我的docs目录结构如下：

docs/
docs/fast-svg/index.html
docs/fast-svg/?ls=distributed&list=1/index.html
docs/index.html
... 其他文件 ...

本地查看docs/fast-svg/?ls=distributed&list=1/index.html文件，确认内容已正确预渲染。但访问https://push-based.github.io/ngx-fast-svg/fast-svg?ls=distributed&list=1时，返回的却是docs/fast-svg/index.html的内容。

最初我尝试使用不带末尾斜杠的路径，但GitHub Pages会执行301重定向：

从：https://push-based.github.io/ngx-fast-svg/fast-svg?ls=distributed&list=1
重定向至：https://push-based.github.io/ngx-fast-svg/fast-svg/?ls=distributed&list=1

GitHub Pages的静态文件服务逻辑不会把URL中的查询参数当作文件路径的一部分，它只会匹配路径部分，直接忽略?后面的查询参数。你现在把查询参数塞进文件夹名的做法，完全不符合静态服务器的解析规则——服务器看到?就会判定后面是参数，根本不会去匹配带?的文件夹。

给你两个靠谱的解决方向：

• 修改预渲染输出路径
  把带查询参数的页面改成合法的路径命名，比如把docs/fast-svg/?ls=distributed&list=1/index.html重命名为docs/fast-svg/distributed-list-1/index.html。之后要么在应用里配置路由映射，让fast-svg?ls=distributed&list=1指向这个新路径，要么直接引导用户访问fast-svg/distributed-list-1。

• 用404页面做路由转发
  利用GitHub Pages的特性：所有未匹配到静态文件的请求都会跳转到404.html。你可以在404.html里写一段JS，解析URL里的查询参数，然后动态加载对应的预渲染内容。比如检测到ls=distributed&list=1时，就加载fast-svg/distributed-list-1/index.html的内容（前提是你已经把预渲染文件改成了这个合法路径）。

重点提醒：文件名和文件夹名里绝对不能用?、&这类特殊字符，静态服务器根本不会把它们当作路径的一部分处理。

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