Debian从8升级到11后连接MySQL报2002套接字错误如何解决

Debian 9起官方源默认将MySQL替换为MariaDB，你从Debian 8跨3个大版本升级到11的过程中，原有MySQL安装包被自动替换为MariaDB兼容包，旧版本配置、服务脚本、数据文件与新环境不兼容，才导致服务启动失败、套接字文件无法生成的问题，配置文件中的MariaDB引用属于正常情况，不是故障根源。

操作前先执行以下命令备份原始数据库文件，避免操作丢失数据

cp -a /var/lib/mysql /var/lib/mysql.bak

• 查看服务启动的具体错误日志，定位根因

cat /var/log/mysql/error.log

• 修复数据目录与运行目录权限
  你手动创建的/run/mysqld目录属于tmpfs临时文件系统，重启会自动清除，且权限配置错误会导致服务无法写入套接字，执行以下命令配置持久化权限规则：

echo "d /run/mysqld 0755 mysql mysql -" > /etc/tmpfiles.d/mysql.conf
systemd-tmpfiles --create /etc/tmpfiles.d/mysql.conf
chown -R mysql:mysql /var/lib/mysql

• 重置服务配置并启动
  首先移除旧的SysV初始化脚本，使用systemd原生服务管理：

mv /etc/init.d/mysql /root/mysql.init.bak
systemctl daemon-reload
systemctl restart mariadb

• 若启动失败提示数据版本不兼容，执行数据结构升级：

mariadb-upgrade -u root -p

• 验证服务状态，确认套接字文件生成：

systemctl status mariadb
ls /run/mysqld/mysqld.sock

• 服务正常启动后，执行全库备份：

mysqldump -u root -p --all-databases > /root/all_databases_backup.sql

如果服务始终无法启动，直接将提前备份的/var/lib/mysql.bak目录完整拷贝到新安装的同版本MariaDB服务器的/var/lib/mysql路径下，修正权限后启动服务即可直接恢复所有数据。

内容的提问来源于stack exchange，提问作者jhly