如何解决安装MySQL后出现的Library报错以及缺少依赖库的问题?

阿丽酱_4895

阿丽酱_4895

2026-07-24

1111人浏览

原创

报错“libaio.so.1: cannot open shared object file”说明mysql 8.0+硬依赖的异步i/o库缺失,需先用ldd确认,再按系统安装libaio(rhel/centos用dnf install libaio,ubuntu 24.04需装libaio1t64并手动创建libaio.so.1软链接),最后执行ldconfig验证。

如何解决安装mysql后出现的library报错以及缺少依赖库的问题?

直接结论:报错里写的那个 libxxx.so.y 就是你要找的靶子,别猜、别跳过、别用 --force,查它、装它、链它。

看到 libaio.so.1: cannot open shared object file 怎么办

这不是“可能缺”,是“一定缺”——MySQL 8.0+ 启动时硬依赖这个库做异步 I/O。常见于最小化安装的 CentOS/RHEL 8+、AlmaLinux、Ubuntu 24.04 等系统。

  • 先确认缺失:ldd $(which mysqld) | grep libaio,输出含 not found 即实锤
  • 按系统装包:
    • CentOS/RHEL/AlmaLinux:sudo dnf install -y libaio
    • Ubuntu/Debian:sudo apt install -y libaio1
    • Ubuntu 24.04(或 Kylin V10)特殊处理:装完 libaio1t64 后,ls /usr/lib/x86_64-linux-gnu/libaio.so* 会看到 libaio.so.1t64.0.2,但 MySQL 要 libaio.so.1 ——得手动建软链接:sudo ln -sf /usr/lib/x86_64-linux-gnu/libaio.so.1t64.0.2 /usr/lib/x86_64-linux-gnu/libaio.so.1,再跑 sudo ldconfig

libnuma.so.1 缺失导致 mysqld 静默退出

这个容易被忽略:即使你的机器是单 NUMA 节点,MySQL 8.0+ 也会调用 numactl 命令做内存策略初始化。缺了它,mysqld 启动后立刻退出,日志里却只报 SSL 或端口错误,纯属干扰项。

MySQL
MySQL

编写正确的MySQL查询,避免字符集、索引和锁方面的常见陷阱。

下载
  • 验证方式:which numactl 返回空,或 ldd $(which mysqld) | grep numa 显示 not found
  • 安装命令:
    • RHEL/CentOS/AlmaLinux:sudo dnf install -y numactl-libs(注意不是 numactl,那是命令行工具,MySQL 只需要库)
    • Ubuntu/Debian:sudo apt install -y libnuma1

报 libssl.so.10 或 libssl.so.3 找不到

OpenSSL 版本错位最典型:MySQL 5.7 二进制包通常要 libssl.so.10,而 Ubuntu 22.04+ 默认只带 libssl.so.3;MySQL 8.0.33+ 则倾向用 libssl.so.3。不能混用。

  • 先查系统实际装了啥:apt list --installed | grep ssl(Ubuntu)或 dnf list installed | grep openssl(RHEL)
  • 匹配安装:
    • Ubuntu 20.04/22.04 装老版 MySQL 5.7?补:sudo apt install -y libssl1.1
    • Ubuntu 24.04 装 MySQL 8.0.33+?确保有:sudo apt install -y libssl3
    • RHEL 9+?可能需额外加:sudo dnf install -y openssl11
  • 别手动复制 .so 文件覆盖系统库——ABI 不兼容会导致 mysqld 崩溃

启动失败但错误日志没提示具体缺哪个库

这是最坑的情况:systemctl start mysqld 成功返回,systemctl status mysqld 却显示 inactive (dead),日志里只有模糊的 “Failed to initialize SSL” 或 “Can’t start server”。本质是动态链接失败,进程在 main() 前就退出了,根本来不及打日志。

  • 绕过 systemd 直接试启动:sudo -u mysql /opt/mysql/bin/mysqld --no-defaults --user=mysql --basedir=/opt/mysql --datadir=/var/lib/mysql --log-error=/var/log/mysql/error.log
  • 看终端是否立即报出 error while loading shared libraries —— 这才是真实缺失项
  • 或者用更底层方式验证:LD_DEBUG=libs /opt/mysql/bin/mysqld --version 2>&1 | grep "libaio\|libnuma\|libssl",能直接看到链接器尝试加载哪些库、卡在哪一步

真正卡住人的从来不是“不知道装什么”,而是装了却还报错——往往因为软链接没建对、numactl-libs 和 numactl 搞混、或者 Ubuntu 24.04 的 libaio.so.1t64.0.2 没映射成 libaio.so.1。盯住 ldd 和 ldconfig -p 的输出,比反复重装 RPM 包管用十倍。

相关专题

更多
mysql修改数据表名
mysql修改数据表名

MySQL修改数据表:1、首先查看数据库中所有的表,代码为:‘SHOW TABLES;’;2、修改表名,代码为:‘ALTER TABLE 旧表名 RENAME [TO] 新表名;’。php中文网还提供MySQL的相关下载、相关课程等内容,供大家免费下载使用。

2023.06.20

2133

6

MySQL创建存储过程
MySQL创建存储过程

存储程序可以分为存储过程和函数,MySQL中创建存储过程和函数使用的语句分别为CREATE PROCEDURE和CREATE FUNCTION。使用CALL语句调用存储过程智能用输出变量返回值。函数可以从语句外调用(通过引用函数名),也能返回标量值。存储过程也可以调用其他存储过程。php中文网还提供MySQL创建存储过程的相关下载、相关课程等内容,供大家免费下载使用。

2023.06.21

1319

5

mongodb和mysql的区别
mongodb和mysql的区别

mongodb和mysql的区别:1、数据模型;2、查询语言;3、扩展性和性能;4、可靠性。本专题为大家提供mongodb和mysql的区别的相关的文章、下载、课程内容,供大家免费下载体验。

2023.07.18

755

5

mysql密码忘了怎么查看
mysql密码忘了怎么查看

MySQL是一个关系型数据库管理系统,由瑞典MySQL AB 公司开发,属于 Oracle 旗下产品。MySQL 是最流行的关系型数据库管理系统之一,在 WEB 应用方面,MySQL是最好的 RDBMS 应用软件之一。那么mysql密码忘了怎么办呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.19

2892

5

mysql创建数据库
mysql创建数据库

MySQL是一个关系型数据库管理系统,由瑞典MySQL AB 公司开发,属于 Oracle 旗下产品。MySQL 是最流行的关系型数据库管理系统之一,在 WEB 应用方面,MySQL是最好的 RDBMS 应用软件之一。那么mysql怎么创建数据库呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.25

4848

4

mysql默认事务隔离级别
mysql默认事务隔离级别

MySQL是一种广泛使用的关系型数据库管理系统,它支持事务处理。事务是一组数据库操作,它们作为一个逻辑单元被一起执行。为了保证事务的一致性和隔离性,MySQL提供了不同的事务隔离级别。php中文网给大家带来了相关的教程以及文章欢迎大家前来学习阅读。

2023.08.08

1099

3

sqlserver和mysql区别
sqlserver和mysql区别

SQL Server和MySQL是两种广泛使用的关系型数据库管理系统。它们具有相似的功能和用途,但在某些方面存在一些显著的区别。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.11

5111

4

mysql忘记密码
mysql忘记密码

MySQL是一种关系型数据库管理系统,关系数据库将数据保存在不同的表中,而不是将所有数据放在一个大仓库内,这样就增加了速度并提高了灵活性。那么忘记mysql密码我们该怎么解决呢?php中文网给大家带来了相关的教程以及其他关于mysql的文章,欢迎大家前来学习阅读。

2023.08.14

4522

7

mysql事务隔离级别
mysql事务隔离级别

mysql规范中定义了四种事务隔离级别,不同的隔离级别对事务的处理有所不同。本专题为大家提供mysql事务隔离级别相关的文章内容,大家可以免费体验。

2023.08.16

5934

11

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PostgreSQL vs MySQL
PostgreSQL vs MySQL

共1课时 | 181人学习

使用phpenv集成环境安装极致CMS
使用phpenv集成环境安装极致CMS

共2课时 | 289人学习