Hexo博客部署仓库失败的问题解决

解决使用Hexo搭建个人博客遇到的一些问题

前言

前几天在使用Hexo和GitHub创建个人博客的时候遇到了一些问题，主要遇到的有两个，一个是刚开始初始化的时候，一个是最后一步部署到GitHub的时候。没错，就很离谱，一个是劝退你，一个是先给你希望，最后再让你绝望。我也试了很久，才找到以下几种解决办法。

一、初始化阶段连接不到GitHub，一直克隆失败

1. 在初始化阶段的坑

在使用hexo init的时候出现下面这样的情况，简直让人不能忍受！报错代码如下：

fatal: unable to access 'https://github.com/hexojs/hexo-starter.git/': Recv failure: Connection was reset
WARN Git clone failed. Copying data instead
FATAL Something's wrong. Maybe you can find the solution here: https://hexo.io/docs/troubleshooting.html
Error: EPERM: operation not permitted, mkdir 'D:'

2. 问题原因及解决方法

2.1 没有配置npm淘宝镜像又没有打开"科学上网"工具

这种情况下，二者完成其一一般都能解决。

（1）配置npm淘宝镜像

淘宝镜像是指淘宝提供的一个软件源，可以用于下载和安装各种软件包。在国内，访问国外的软件源速度很慢，而淘宝镜像是国内的，下载速度快，可以提高软件安装的效率。

执行如下命令：

npm config set registry https://registry.npm.taobao.org

配置完成后，继续运行hexo init就能解决了。

（2）打开科学上网工具

直接运行hexo init就行了。

2.2 打开了"科学上网"工具，运行hexo init还是一直报上面的错误！

这种情况可能是科学上网工具不稳定导致的网络连接不稳定，这里建议关掉并退出工具，再次执行hexo init初始化命令。如果还不行，这里推荐一种不用科学上网，不连接到GitHub也能初始化的操作：

$ npx hexo init [myblog]

在git bash运行以上命令，简直是不愿意使用科学上网工具的小伙伴的福音！它会直接在当前文件夹下创建一个myblog的文件夹并进行初始化。

二、在最后一步将自己建好的博客上传到GitHub时失败

1. 问题描述如下

fatal: Could not read from remote repository.
Please make sure you have the correct access rights
and the repository exists.
FATAL Something's wrong. Maybe you can find the solution here: https://hexo.io/docs/troubleshooting.html
Error: Spawn failed
    at ChildProcess.<anonymous> (D:\Myblog\myblog\node_modules\hexo-util\lib\spawn.js:51:21)
    at ChildProcess.emit (events.js:314:20)
    at ChildProcess.cp.emit (D:\Myblog\myblog\node_modules\cross-spawn\lib\enoent.js:34:29)
    at Process.ChildProcess._handle.onexit (internal/child_process.js:276:12)
INFO  Deploying: git
INFO  Clearing .deploy_git folder...
INFO  Copying files from public folder...
INFO  Copying files from extend dirs...
branch 'master' set up to track 'origin/master'.
fatal: Could not read from remote repository.
Please make sure you have the correct access rights
and the repository exists.
FATAL Something's wrong. Maybe you can find the solution here: https://hexo.io/docs/troubleshooting.html
Error: Spawn failed

一般这种情况大多是网络原因导致的，科学上网工具也不一定管用，我们可以通过修改SSH配置来解决。

首先执行以下命令测试连接：

$ ssh -vT git@github.com

从输出可以看出，虽然访问的IP地址目测没什么问题，但是不管重复几次还是连接超时导致无法部署，这说明22端口目前是有问题的。

2. 解决办法

2.1 配置SSH文件

在C:\Users\Administrator\.ssh中找到ssh文件夹（此前配置SSH时会生成该文件夹）。

在.ssh文件夹中新建文本文件config，不带后缀（可以新建文本文档，去掉.txt后缀）。

打开config文件，输入以下内容，保存后即可，其中xxx@qq.com为你自己的邮箱：

Host github.com
  User xxx@qq.com
  Hostname ssh.github.com
  PreferredAuthentications publickey
  IdentityFile ~/.ssh/id_rsa
  Port 443

2.2 修改hosts文件

操作系统hosts文件的权限优先级高于DNS服务器。在C:\Windows\System32\drivers\etc目录下找到并修改hosts文件，增加一条github.com的域名映射可以解决。

# GitHub
140.82.113.4 github.com

再次运行ssh -vT git@github.com检查，发现连接成功了！

最后，输入hexo d就能上传部署成功了！

总结

以上就是所有要讲的内容了，只是我个人在搭建过程中遇到的一些问题，仅供参考一下，每个人遇到的问题可能都是不一样的，具体问题具体分析，多查查，多看看，一般都能解决的。