一. 背景

最近在看黑马前端的学习视频，视频讲到使用vue做电商管理后台，由于采用的是前后端分离的模式，所以后台的接口是必须的，视频中的老师是使用windows电脑，采用的是phpStudy启动mysql数据库，然后导入sql文件的方式。我的是mac电脑，然后同样采用phpStudy的方式，但是一直导入的数据不全，明明一个完整的sql文件，导入以后只有一个表，所以导致使用postman测试login接口的时候一直失败。

后来我想了下，视频中的目标就是启动mysql，然后创建数据库，导入.sql文件，再使用node.js把后台项目跑起来（后台项目会访问mysql数据库，然后返回数据），跑起来之后再通过postman测试接口是否正常。然后我就在mac中实现了这个目标，所以才有此文。

二. 安装mysql

本文需要的mysql、postman自己网上下载，服务端项目代码在文末。

双击mysql的.dmg文件进入安装程序，安装过程中会让你设置root账户的密码，这个密码一定要记住，因为后面访问数据库会用到
安装完之后点击🍎-系统偏好设置-MYSQL，可以发现mysql默认已经启动了
打开终端，将MySQL的bin目录加入系统PATH，做法是，在用户目录（/Users/你的用户名）下的.bash_profile文件（如果没有就自己创建一个）中，添加 export PATH=$PATH:/usr/local/mysql/bin，添加完成之后保存，然后在终端执行：source ./.bash_profile使文件生效
接下来我们就可以在终端访问mysql了
① 登录数据库：执行mysql -u root -p命令，命令意思是使用root账号登录数据库，需要输入刚才设置的密码（如果提示zsh: command not found: mysql，则先执行source ./.bash_profile），如果数据库进入成功，则光标会出现在mysql>后面以便你输入sql命令
② 创建数据库：在刚才的mysql>后面执行create database 数据库名称;（注意：sql命令后面有;）
③ 查看数据库列表：show databases;
④ 进入某个数据库：use 数据库名称;
⑤ 导入sql文件：source 『将.sql文件拖拽到这里，终端会自动显示其文件目录』（本文需要的.sql文件在文末服务端项目代码的db/mydb.sql目录）
⑥ 显示本库中的所有表：show tables;，如果本库中的表没啥问题，说明上一步的.sql文件导入没问题
⑦ 退出数据库操作：exit;

三. 启动服务端接口项目

在文末找到vue_api_server文件（这是服务端的源代码，需要电脑安装node.js环境才可以运行），解压
打开终端，cd到解压后的项目，执行npm install安装依赖包
打开项目中的default.json文件，将项目中访问mysql数据库的名称、账号、密码修改为我们上面创建的数据库名称、账号、密码，如下：

"db_config" : {
    "protocol" : "mysql",
    "host" : "127.0.0.1",
    "database" : "mydb",  // 数据库名称
    "user" : "root",  // 账号
    "password" : "123456", // 密码
    "port" : 3306
}

在终端cd到项目目录，执行node app.js启动项目，如果打印如下信息并且没报错就说明项目启动成功

/Users/xxxx/Desktop/vue_api_server/routes/api/private/v1/users.js      │ put    │ /api/private/v1/users/:id/state/:state

可能遇到的错误：

如果执行命令之后报错：Error: ER_NOT_SUPPORTED_AUTH_MODE: Client does not support authentication protocol requested by server; consider upgrading MySQL client

错误原因是mysql8.0更改了密码默认的认证插件为Caching_sha2_password，原来是mysql_native_password，更改为原来的就可以了，需要按照上面命令重新进入数据库，执行如下sql操作：

1、使用管理员运行命令提示符
2、进入到mysql安装目录的bin目录下默认安装路径大概是（C:\Program Files\MySQL\MySQL Server 8.0\bin）
3、在命令提示行中键入：mysql -u root -p
4、mysql> alter user 'root'@'localhost' identified with mysql_native_password by 'asd123456';  
//此时得到提示Query OK, 0 rows affected (0.01 sec)，这里是修改密码的认证方式，root是用户名，后面是密码
5、mysql> flush privileges;  //此时得到提示Query OK, 0 rows affected (0.01 sec)，这里是重启权限
6、mysql> exit;  // 退出mysql

如果执行命令之后报错：Error: listen EADDRINUSE: address already in use :::8888

错误原因是8888端口被占用，只需要强制关闭占用端口的程序就好了，首先直接列出使用了该端口的应用程序lsof -i:端口号，打印如下：

ColadeMBP:vue_api_server xujincheng$ lsof -i:8888
COMMAND  PID       USER   FD   TYPE             DEVICE SIZE/OFF NODE NAME
node    1454 xujincheng   24u  IPv6 0x1f8f9382bea99a7b      0t0  TCP *:ddi-tcp-1 (LISTEN)

然后再杀死对应的PID：kill -9 对应的pid

ColadeMBP:vue_api_server xujincheng$ kill -9 1454

重新执行node app.js启动项目。

四. 使用postman测试接口是否正常

服务端项目启动成功之后就可以使用postman测试接口了，打开postman，点击+，修改请求方式为post，请求地址为http://127.0.0.1:8888/api/private/v1/login，点击body，点击x-www-form-urlencoded，传入参数如下，点击send，结果如下说明接口正常。