vscode远程debug mysql

使用自己下载的源代码编译并安装

〇可以提前安装的依赖

apt install libssl-dev

apt install pkg-config

①安装依赖

个人本地操作系统为Ubuntu18.04LTS，编译安装需要以下依赖。

apt install build-essential cmake bison libncurses5-dev libssl-dev pkg-config

详细依赖列表参考https://dev.mysql.com/doc/refman/8.0/en/source-installation.html。如果有其他缺失的依赖，cmake的时候会检查出来，甚至会打印输出具体的apt / yum命令，把命令拷下来执行一下再编译即可。

②下载源码

源码包分为带boost版和不带boost版的，方便起见直接下载带boost的。

wget https://dev.mysql.com/get/Downloads/MySQL-8.0/mysql-boost-8.0.16.tar.gz
tar xzv -f mysql-boost-8.0.16.tar.gz
cd mysql-8.0.16/ ; ls

③编译安装

cmake的完整选项列表参考https://dev.mysql.com/doc/refman/8.0/en/source-configuration-options.html。

cmake时按照提示添加-DFORCE_INSOURCE_BUILD=1

cmake -DCMAKE_INSTALL_PREFIX=/usr/local/mysql -DMYSQL_DATADIR=/usr/local/mysql/data -DWITH_BOOST=boost -DFORCE_INSOURCE_BUILD=ON -DFORCE_INSOURCE_BUILD=1
make && make install

④初始配置

详细参考https://dev.mysql.com/doc/refman/8.0/en/installing-source-distribution.html。

添加mysql用户组和配置文件权属。

groupadd mysql
useradd -g mysql mysql
mkdir -p /usr/local/mysql/data
chown -R mysql:mysql /usr/local/mysql

/usr/local/mysql/bin/mysqld --initialize --user=mysql --basedir=/usr/local/mysql --datadir=/usr/local/mysql/data
这一步会打印输出随机生成的root账号初始密码，找个小本本记下来待会要用这个密码连接登录的。[Server] A temporary password is generated for root@localhost: T9Er+PlKFu-6

生成ssl(可选)。

/usr/local/mysql/bin/mysql_ssl_rsa_setup --user=mysql --basedir=/usr/local/mysql --datadir=/usr/local/mysql/data
新建一个全局用的简单的配置文件。

vim /etc/my.cnf

然后写入以下内容

[client]
socket = /tmp/mysql.sock[mysqld]
socket = /tmp/mysql.sock
basedir = /usr/local/mysql
datadir = /usr/local/mysql/data

⑤开启服务

详细参考https://dev.mysql.com/doc/refman/8.0/en/postinstallation.html。

配置mysqld服务。

cp /usr/local/mysql/support-files/mysql.server /etc/init.d/mysqld
chmod +x /etc/init.d/mysqld
update-rc.d mysqld defaults
service mysqld start

添加PATH。

echo -e '# MySQL PATH\nexport PATH=/usr/local/mysql/bin:$PATH\n' >> /etc/profile
source /etc/profile

连接登录MySQL并修改root账户密码(需要使用第④步生成的密码)。

mysql -uroot -p'!YAH0uS%AS>q'
mysql> ALTER USER 'root'@'localhost' IDENTIFIED BY '1024';

因为本次安装只是个人使用(非生产环境)，所以可以额外的将账户密码信息写入配置文件，以后连接就不用再输入了(懒人专用)。然后进入MySQL修改开启root账户可远程连接。

把这几行添加到client选项组下面

vim /etc/my.cnfuser = root
password = 1024
port = 3306

然后试着启动一下mysql，其下的 UPDATE 语句是为了使远程用户也能连接上mysql。

root@zoo:/home/zoo/mysql-8.0.16# mysql
Welcome to the MySQL monitor.  Commands end with ; or \g.
Your MySQL connection id is 11
Server version: 8.0.16 Source distributionCopyright (c) 2000, 2019, Oracle and/or its affiliates. All rights reserved.Oracle is a registered trademark of Oracle Corporation and/or its
affiliates. Other names may be trademarks of their respective
owners.Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.mysql> UPDATE `mysql`.`user` SET `Host` = '%' WHERE `User` = 'root';
Query OK, 1 row affected (0.01 sec)
Rows matched: 1  Changed: 1  Warnings: 0mysql> FLUSH PRIVILEGES;
Query OK, 0 rows affected (0.01 sec)mysql>

启动成功之后，按照以下方法进行配置：

一、插件与依赖安装

在本地机器上:

安装目前最新版本支持 Remote - Development 插件
安装 VSCode 扩展 “Remote - Development”, 方法是左下角 管理（⚙） -> 扩展, 直接搜索商店
安装兼容 OpenSSH 的 SSH 客户端, 我安装的

在远程机器上:

编译安装mysql（注意编译时需开启 -DWITH_DEBUG=1），并且启动mysql实例，这里我是在centos（CentOS Linux release 7.7.1908）上面编译安装的mysql8.0.18（为方便没有 mysql编译安装经验的读者回头另写一篇 mysql8.0.18编译安装）
安装 gdb, yum install gdb
安装 gdbserver, yum install gdb-gdbserver
启动 ssh 服务端, 通常默认已经启动

二、vscode ssh打开对应的文件夹

三、关闭正在运行的mysqld实例

service mysqld stop

四、创建debug用的配置文件

client端配置：

首先创建一个.vscode文件夹，然后chmod 777 -R .vscode赋予权限

在.vscode下创建配置文件launch.json，配置如下：

{// Use IntelliSense to learn about possible attributes.// Hover to view descriptions of existing attributes.// For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387"version": "0.2.0","configurations": [{"name": "gdb remote launch","type": "cppdbg","request": "launch",// 前面如果按照这教程安装，program不需要修改，makeinstall的路径就是这个。"program": "/usr/local/mysql/bin/mysqld","stopAtConnect": true,"environment": [],"externalConsole": false,"MIMode": "gdb","miDebuggerPath": "gdb","miDebuggerArgs": "gdb","linux": {"MIMode": "gdb","miDebuggerPath": "/usr/bin/gdb","miDebuggerServerAddress": "${机器的ip}:2333"},"logging": {"moduleLoad": false,"engineLogging": false,"trace": false,},"setupCommands": [{"description": "Enable pretty-printing for gdb","text": "-enable-pretty-printing","ignoreFailures": true}],"cwd": "${workspaceFolder}",}]
}

五、debug

server端：

首先启动一个gdbserver：

gdbserver localhost:2333 /usr/local/mysql/bin/mysqld --defaults-file=/etc/my.cnf --user=mysql
或者
gdbserver localhost:2333 /usr/local/mysql/bin/mysqld --user=mysql --basedir=/usr/local/mysql --datadir=/usr/local/mysql/data
随便挑一个吧，我也忘记了是哪个才能启动成功了。
按理说两个是一样的，因为基本信息都在my.cnf配置好了。

然后对应输出：

此时就可以开始使用vscode进行debug了。

client端：

output界面出现这个提示，先点继续，跳过：

然后就运行到我自己打的断点处了！

继续点击继续按钮

直至显示这样的输出以及表示正在运行：

这时候回头看开启gdbserver的服务器，显示ready for connections，那就是成功了。

这时候可以去连接3306端口登录服务器，也是成功的：

大功告成！

遇到的一些问题

debug运行过程出现了这个问题：

有可能是启动了多个mysql实例，然后使用的同一份配置导致冲突了。尝试将ibdata1文件删掉（这是错误的做法），后面只能重新安装。

另一个问题：

重新make install之后启动，出现了这个问题：

这时候把my.cnf里的socket路径换掉：

[client]
socket = /tmp/mysqly.socok
user = root
password = 1024
port = 3306[mysqld]
socket = /tmp/mysqly.sock
basedir = /usr/local/mysql
datadir = /usr/local/mysql/data

还是没用，把登录语句换成这样，不走本机socket算了，然后就能登录进去了。

mysql -h127.0.0.1 -P3306 -u root -p'w/hqkSt+d3zq'

参考博客：

Ubuntu Linux系统MySQL8.0源码编译安装笔记_蛙鳜鸡鹳狸猿的博客-CSDN博客_ubuntu cannot find appropriate system libraries

windows系统vscode远程调试mysql_ITPUB博客