安装配置MariaDB后重启mysql服务提示找不到mysql.service单元

前置部署操作步骤 #

• 依次执行系统更新与软件安装命令：
  • sudo apt-get update
  • sudo apt-get install mariadb-server-10.3
  • sudo apt-get install libmysqlclient-dev
• 使用vim打开全局数据库配置文件：sudo vim /etc/mysql/my.cnf
• 在配置文件内追加utf8mb4字符集适配规则：

  [mysqld]
  character-set-client-handshake = FALSE
  character-set-server = utf8mb4
  collation-server = utf8mb4_unicode_ci
  
  [mysql]
  default-character-set = utf8mb4
  

• 配置修改完成后尝试重启服务使规则生效，执行命令：sudo service mysql restart

故障现象 #

执行重启命令后终端返回完整报错：

ubuntu@ip-172-31-47-177:~$ sudo service mysql restart
Failed to restart mysql.service: Unit mysql.service not found.

故障原因 #

该报错核心是Ubuntu软件源中MariaDB 10.3版本默认注册的systemd服务单元为mariadb.service，未生成兼容MySQL命名规则的mysql.service软链接，直接调用mysql服务名时会触发服务单元不存在的错误。

修复操作 #

• 先查询系统内实际存在的数据库服务单元，执行校验命令：systemctl list-unit-files | grep -E 'mysql|mariadb'
• 确认匹配到mariadb.service条目后，使用正确的服务名执行重启操作：
  • 传统service调用方式：sudo service mariadb restart
  • systemd标准调用方式：sudo systemctl restart mariadb
• 重启完成后执行验证命令，确认字符集配置已生效：mysql -e "show variables like '%char%';"，检查返回结果中服务端、客户端的默认字符集是否为utf8mb4。

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