【Swagger+YApi安装部署

Swagger+YApi安装部署"/>

【Swagger+YApi安装部署

Swagger+YApi学习笔记

学习YApi踩坑记录的一些解决办法，感觉好多坑都遇到了。5555.、、、、
我安装的步骤是采用这个大佬的，但是期间遇到了很多额外的问题：
安装
环境准备
● 安装nodejs，直接下载安装包双击安装即可，这里安装的是12.14.0版本，下载地址：.14.0/node-v12.14.0-x64.msi;

● 安装MongoDB，参考《MongoDB快速入门，掌握这些刚刚好！》中的安装即可，这里安装的是4.2.17版本

踩雷：
● 使用npm命令来安装yapi-cli：

npm install -g yapi-cli --registry  

报错

npm ERR! code ERR_TLS_CERT_ALTNAME_INVALID
npm ERR! errno ERR_TLS_CERT_ALTNAME_INVALID
npm ERR! request to failed, reason: Hostname/IP does not match certificate’s altnames: Host: registry.nmp.taobao. is not in the cert’s altnames: DNS:*.tmall,
npm ERR! A complete log of this run can be found in:
npm ERR! C:\Users\xu\AppData\Roaming\npm-cache_logs\2021-12-27T09_56_16_253Z-debug.log

输入命令

1. npm install -g supervisor

再次执行 npm install -g yapi-cli --registry
依旧报错出现404问题

npm ERR! code E404
npm ERR! 404 Not Found - GET
npm ERR! 404
npm ERR! 404 ‘yapi-cli@latest’ is not in the npm registry.
npm ERR! 404 You should bug the author to publish it (or use the name yourself!)
npm ERR! 404
npm ERR! 404 Note that you can also install from a
npm ERR! 404 tarball, folder, http url, or git url.
npm ERR! A complete log of this run can be found in:
npm ERR! C:\Users\xu\AppData\Roaming\npm-cache_logs\2021-12-27T09_58_28_806Z-debug.log

原因是npm的源镜像问题
使用nmp本地仓库

npm set registry :2018

再执行 ：

npm install

报错：
npm WARN saveError ENOENT: no such file or directory, open ‘C:\Users\xu\package.json’
npm notice created a lockfile as package-lock.json. You should commit this file.
npm WARN enoent ENOENT: no such file or directory, open ‘C:\Users\xu\package.json’
npm WARN xu No description
npm WARN xu No repository field.
npm WARN xu No README data
npm WARN xu No license field.

根据错误提示，是系统没有‘package.json’这个文件导致。这个文件的作用就是管理你本地安装的npm包。
所以我们要生成一个package.json文件，执行命令：

npm init

创建package.json 文件

npm init -y

再次执行 npm install时再次报错，原因是package.json字段的有两个字段没有内容
npm WARN xu@1.0.0 No description
npm WARN xu@1.0.0 No repository field.
如果是windows用户，直接用命令打开文件就可以，将字段内容填充

start package.json

如果是linux用户，用vim命令打开文件，将字段内容填充

vim package.json

description字段的内容无所谓，不为空即可；第二个权限设置成私有的即可。接下来就可以正常使用npm安装命令了
然后重新执行命令

npm install -g yapi-cli --registry 

下一步执行：

yapi server

用浏览器打开 http://localhost:9090/

● 安装完成后会输出如下信息，提示YApi的默认管理员账号密码及访问地址；

server/install.js log: mongodb load success… 初始化管理员账号成功,账号名：“admin@admin”，密码：“ymfe” 部署成功，请切换到部署目录，输入： “node vendors/server/app.js” 指令启动服务器, 然后在浏览器打开 http://127.0.0.1:3000 访问

部署完成后，执行发现少了一个js的包，所以自己下载完整的数据进行导入

git地址：

internal/modules/cjs/loader.js:800 throw err;
^ Error: Cannot find module ‘fs-extra’ Require stack:

● 通过页面访问Yapi，默认账号密码为admin@admin:ymfe，访问地址：http://localhost:3000
根据账号密码进行登录：

yapi每次启动：
切换相关目录下：D:\YApi\YApi-master\my-yapi\vendors
启动命令：npm start server/app.js --watch