From 15efde27570d750a9675e79358297fe4b5163789 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E5=90=88=E9=87=91=E6=9D=A5=E4=BA=86?= Date: Tue, 13 Jan 2026 07:31:36 +0000 Subject: [PATCH] =?UTF-8?q?update=206-oper-guide/8-troubleshooting.md.=20#?= =?UTF-8?q?##=20=E5=88=86=E4=BA=AB=E6=95=B0=E6=8D=AE=E5=BA=93=E5=88=9D?= =?UTF-8?q?=E5=A7=8B=E5=8C=96=E5=BC=82=E5=B8=B8=E8=A7=A3=E5=86=B3=E6=96=B9?= =?UTF-8?q?=E6=B3=95?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit ```bash [root@GreatSQL-02 GreatSQL]# /usr/local/GreatSQL-8.4.4-4-Linux-glibc2.28-aarch64/bin/mysqld --no-defaults --user=mysql --log_error_verbosity=3 --datadir=/data/GreatSQL --initialize /usr/local/GreatSQL-8.4.4-4-Linux-glibc2.28-aarch64/bin/mysqld: error while loading shared libraries: libaio.so.1: cannot open shared object file: No such file or directory ``` Signed-off-by: 合金来了 <593713+lvhejin@user.noreply.gitee.com> --- 6-oper-guide/8-troubleshooting.md | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/6-oper-guide/8-troubleshooting.md b/6-oper-guide/8-troubleshooting.md index 10e7781..ef4c31a 100644 --- a/6-oper-guide/8-troubleshooting.md +++ b/6-oper-guide/8-troubleshooting.md @@ -2,6 +2,25 @@ 本篇文档总结了使用 GreatSQL 时的常见错误。在遇到这些相关错误时，可以通过本文档的问题排查思路检查发生错误原因并进行处理。 +## 启动 GreatSQL 失败，提示`libaio.so.1: cannot open shared object file: No such file or directory` + +> 执行 systemctl start greatsql 没有等待时间，瞬间完成（直觉告诉我应该是初始化失败了，正常情况下会等待几秒钟）； +> 手动初始化：`/usr/local/GreatSQL-8.4.4-4-Linux-glibc2.28-aarch64/bin/mysqld --no-defaults --user=mysql --log_error_verbosity=3 --datadir=/data/GreatSQL --initialize` +> 报异常信息：`/usr/local/GreatSQL-8.4.4-4-Linux-glibc2.28-aarch64/bin/mysqld: error while loading shared libraries: libaio.so.1: cannot open shared object file: No such file or directory` +### 解决方法： + +> libaio 是 Linux 异步 I/O 库，GreatSQL/MySQL 底层依赖它来提升磁盘 I/O 性能，必须安装。根据系统的包管理器选择对应命令： +#### 1. CentOS/RHEL/AlmaLinux（yum 包管理器） +```bash +# 安装 libaio 及开发包（aarch64 架构适配） +yum install -y libaio libaio-devel +``` +#### 2. Debian/Ubuntu（apt 包管理器） +```bash +# 更新源后安装 +apt update && apt install -y libaio1 libaio-dev +``` + ## 安装完 GreatSQL 后，启动失败，提示 `valid data directory` 这个问题通常发生在一个全新的环境中手动安装 GreatSQL 二进制包的时候。 -- Gitee