mysql.service必须放在/etc/systemd/system/下,ExecStart需用绝对路径且不带shell语法,Type=notify需MySQL≥5.7.6并启用WITH_SYSTEMD,启动失败应查journalctl而非MySQL日志。

mysql.service 文件必须放在 /etc/systemd/system/ 下
systemd 不会从 /usr/lib/systemd/system/ 或其他路径自动加载自定义服务文件,除非显式启用。把 mysql.service 放错位置(比如丢进 /etc/init.d/ 或当前目录)会导致 systemctl daemon-reload 后仍提示 Unit mysql.service not found。
实操建议:
- 用
sudo cp mysql.service /etc/systemd/system/mysql.service确保路径唯一正确 - 执行
sudo systemctl daemon-reload后,再用systemctl list-unit-files | grep mysql验证是否识别到 - 别改名成
mysqld.service—— 如果你用的是 Oracle MySQL 官方二进制包,默认期望的服务名就是mysql;Percona 或 MariaDB 则可能用mysqld,名字必须和实际启动命令、配置路径对得上
ExecStart 必须指定绝对路径且不能带 shell 语法
常见错误是写成 ExecStart=/usr/local/mysql/bin/mysqld --defaults-file=/etc/my.cnf 却没加 --user=mysql,或更糟:写成 ExecStart=sh -c "/path/to/mysqld ..."。systemd 不调用 shell,不支持管道、重定向、变量展开,sh -c 会直接失败并报 Failed at step EXEC spawning。
实操建议:
-
ExecStart值必须是可执行文件的绝对路径,参数全部平铺,例如:ExecStart=/usr/local/mysql/bin/mysqld --defaults-file=/etc/my.cnf --user=mysql - 如果需要预设环境变量(如
LD_LIBRARY_PATH),用Environment=行,不要塞进ExecStart - 务必确认
mysql用户存在且对数据目录(如/usr/local/mysql/data)有读写权限,否则启动卡在Starting MySQL...后无日志
Type=notify 要求 mysqld 支持 systemd 通知机制
MySQL 5.7.6+ 官方二进制包默认支持 Type=notify,但如果你用的是自己编译的版本、旧版(如 5.6)、或某些第三方打包(如某些 Alpine 镜像里的 mariadb),mysqld 根本不发 sd_notify,systemd 就会等超时(默认 90s),最终报 Timeout start-limit hit 并标记为 failed。
实操建议:
- 先试
Type=simple:它只要进程 fork 出来就认为启动成功,适合绝大多数场景 - 若坚持用
Type=notify,请确认 MySQL 版本 ≥ 5.7.6 且编译时启用了-DWITH_SYSTEMD=ON(可通过mysqld --version和ldd $(which mysqld) | grep systemd辅助判断) - 搭配
NotifyAccess=all更稳妥,避免因权限问题收不到通知
启动失败时看 journalctl -u mysql -n 50 -f 而不是 /var/log/mysql/error.log
systemd 会接管标准输出和标准错误,即使你在 my.cnf 里写了 log-error=/var/log/mysql/error.log,实际日志也可能被截断或不完整。很多“启动无声失败”问题,真正原因藏在 systemd 的 journal 里,比如 Permission denied、Cannot allocate memory、Can't open shared library 这类底层错误根本不会写进 MySQL 自己的日志文件。
实操建议:
- 每次改完
mysql.service,先sudo systemctl daemon-reload,再sudo systemctl start mysql,立刻跟一句journalctl -u mysql -n 50 -f - 注意看第一行 timestamp 是否比系统时间早很多——说明 journal 没刷出来,可加
--all参数强制显示所有字段 - 如果看到
Failed to connect to bus,说明你没用sudo执行journalctl
--user、多一个 $ 符号、路径少个斜杠,都可能让服务卡在“激活中”不动。










