Vue 路由器、GitHub 页面和自定义域不适用于路由链接
Posted
技术标签:
【中文标题】Vue 路由器、GitHub 页面和自定义域不适用于路由链接【英文标题】：Vue Router, GitHub Pages, and Custom Domain Not Working With Routed Links 【发布时间】：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 产生负面影响。
【参考方案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，这也应该有效，使用相同的技巧。
【讨论】：
以上是关于Vue 路由器、GitHub 页面和自定义域不适用于路由链接的主要内容，如果未能解决你的问题，请参考以下文章