一. 背景
最近在看黑马前端的学习视频,视频讲到使用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,结果如下说明接口正常。
服务端项目代码地址:https://github.com/iamkata/mysql-postman-serveCode