Vue 路由器、GitHub 页面和自定义域不适用于路由链接答案

【问题标题】：Vue Router, GitHub Pages, and Custom Domain Not Working With Routed LinksVue 路由器、GitHub 页面和自定义域不适用于路由链接
【发布时间】：2021-04-06 15:38:42
【问题描述】：

我的域名：myname.com
我的 GitHub 仓库：myname
我的 GitHub 名称：myname

底层 GH-Pages 网址：myname.github.io/myname

我的问题：我使用 History Vue Router 设置了以下页面：主页、联系人、项目。
每当我转到myname.com/contact 时，它都会将我路由到 404。当我单击链接将我重定向到/contacts 时，它会将其推送到地址栏，但如果您刷新，它会路由到 404。我读过以下帖子：Deploy Vue to GitHub Pages. Error with vue-router 和 Vue router on page refresh gets 404，但问题仍然存在并且自定义域增加了复杂性。我也读过这个：Vue Router return 404 when revisit to the url 但是，有一个 React Router 页面的示例，其中一个浏览器路由器在 GH-Pages 上工作：https://milosrancic.github.io/reactjs-website/activities，repo：https://github.com/milosrancic/reactjs-website。

这是我所做的：

我的package.json 有以下行："homepage": "https://myname.com/"
我的vue.config.js 就是这样的：

module.exports = {
    publicPath: '/'
  }

我的路由器在我的路径上：/src/router/index.js，传入main.jsnew Vue()，并像这样导出：

export default new VueRouter({
    base: process.env.BASE_URL,
    mode: 'history',
    routes
})

在我的App.vue（入口组件）中，模板如下所示：

<template>
  <div id="app">
    <nav-bar></nav-bar>
    <router-view></router-view>
  </div>
</template>

【问题讨论】：

GitHub 不会将这些请求重定向到您的应用。 router.vuejs.org/guide/essentials/history-mode.html 进行解释。快速解决方法是删除 mode: 'history'
您链接的“反应”答案也适用于您的应用。您的 SPA 使用什么技术框架并不重要。当请求特定路由（或全部）时，您仍然需要告诉路由器重定向到您的应用程序的入口点。如果路由器没有将请求指向应用程序，应用程序将忽略该请求，并且路由器会以404 进行响应。我不确定 github 是否在他们的免费包中提供了包罗万象/重定向的能力。另一种方法是放弃mode: 'history'，因为这样您的所有应用链接都将指向入口网址（使用不同的#）。
所以没有办法将历史/浏览器路由器与 GH-Pages 一起使用？我不希望在 URL 前面有散列。我认为我不能将 .htaccess 文件提供给我的存储库以使其应用于我的页面。也许我需要为此离开 GH-Pages？ @tao
肯定有。但我不知道 GitHub 是否免费提供。这里的重点是：您的问题与 Vue 无关，与 GitHub 路由设置有关。含义：如果您在 GitHub 上寻找任何 React、Angular、Vue、Svelte 或任何其他 SPA 替代品，您可能会找到答案。但这是关于如何设置 GitHub，而不是应用程序。
好的，所以this guy 提出了一个非常酷的解决方案。 GH 允许您使用自己的 404 模板。他没有放置那个模板，而是放置了一个页面，该页面使用正确的 URL 重定向到入口点。不过，我还不确定他是如何在浏览器地址中屏蔽它的。虽然开箱即用，但我认为该解决方案会对 SEO 产生负面影响。

标签： javascript vue.js vue-router github-pages

【解决方案1】：

我不完全理解您关于重新路由为何/如何工作的评论/困惑，因为您正确总结了前半部分，即 Github 将其视为无效 URL 并将其发送到您的自定义 404 页面。然后 404 页面将其转换为指向根页面 index.html 的查询字符串。

您是否在设置中缺少自定义index.html 页面？ index.html 本身将查询字符串解码回“路由参数”类型的表示，以便当您的应用实际加载时，它可以使用正确的视图和状态进行初始化。

我实际上在我的 GH pages 网站上使用了这个精确的设置：https://mirajp.github.io --> https://www.miraj.dev

【讨论】：

是的，我很抱歉。我已经找到了使用 GitHub 的 404 的解决方法。我正在做一些测试并写一个详细的答案。

【解决方案2】：

我无法通过 Vue 解决问题，但正如 tao 所提到的，这可能是 GitHub 以及它们如何处理 URL 的问题。最简单的解决方法是改用哈希路由器，以使条目 URL 保持静态。但是，这会在您的 URL 中引入可以说是令人反感的 /#/。

鉴于原生不支持包罗万象的路由，有人找到了解决方法：https://github.com/rafgraph/spa-github-pages。 注意：这可能对 SEO 不利，因为预期的 URL 实际上并不存在。这是他们的 404 重定向并在索引页面上处理它的一个技巧。这是一个投资组合网站，因此，我现在可以接受。如果我或其他人找到更好的解决方案，则会更新。

解决方法：

在/public 中添加一个名为404.html 的文件并粘贴以下内容：

<!DOCTYPE html>
<html>
  <head>
    <meta charset="utf-8">
    <title>CHANGE THIS TO YOUR TITLE</title>
    <script type="text/javascript">
      // MIT License
      // https://github.com/rafgraph/spa-github-pages
      // This script takes the current url and converts the path and query
      // string into just a query string, and then redirects the browser
      // to the new url with only a query string and hash fragment,
      // e.g. https://www.foo.tld/one/two?a=b&c=d#qwe, becomes
      // https://www.foo.tld/?/one/two&a=b~and~c=d#qwe
      // Note: this 404.html file must be at least 512 bytes for it to work
      // with Internet Explorer (it is currently > 512 bytes)

      // If you're creating a Project Pages site and NOT using a custom domain,
      // then set pathSegmentsToKeep to 1 (enterprise users may need to set it to > 1).
      // This way the code will only replace the route part of the path, and not
      // the real directory in which the app resides, for example:
      // https://username.github.io/repo-name/one/two?a=b&c=d#qwe becomes
      // https://username.github.io/repo-name/?/one/two&a=b~and~c=d#qwe
      // Otherwise, leave pathSegmentsToKeep as 0.
      var pathSegmentsToKeep = 0;

      var l = window.location;
      l.replace(
        l.protocol + '//' + l.hostname + (l.port ? ':' + l.port : '') +
        l.pathname.split('/').slice(0, 1 + pathSegmentsToKeep).join('/') + '/?/' +
        l.pathname.slice(1).split('/').slice(pathSegmentsToKeep).join('/').replace(/&/g, '~and~') +
        (l.search ? '&' + l.search.slice(1).replace(/&/g, '~and~') : '') +
        l.hash
      );

    </script>
  </head>
  <body>
  </body>
</html>

在/public/index.html 中，在<head> 的<title> 之后添加以下内容：

<script type="text/javascript">
// MIT License
// https://github.com/rafgraph/spa-github-pages
// This script checks to see if a redirect is present in the query string,
// converts it back into the correct url and adds it to the
// browser's history using window.history.replaceState(...),
// which won't cause the browser to attempt to load the new url.
// When the single page app is loaded further down in this file,
// the correct url will be waiting in the browser's history for
// the single page app to route accordingly.
(function(l) {
    if (l.search[1] === '/' ) {
    var decoded = l.search.slice(1).split('&').map(function(s) { 
        return s.replace(/~and~/g, '&')
    }).join('?');
    window.history.replaceState(null, null,
        l.pathname.slice(0, -1) + decoded + l.hash
    );
    }
}(window.location))
</script>

这对我有用，我现在只需输入myname.com/contact 即可访问联系人页面。如果您在 /public 中嵌套了 SPA，这也应该有效，使用相同的技巧。

【讨论】：