From c6bd20a63d205373419700d6dc0ea954db38adcb Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=90=88=E9=87=91=E6=9D=A5=E4=BA=86?= <lvhejin@foxmail.com>
Date: Tue, 13 Jan 2026 07:45:58 +0000
Subject: [PATCH] =?UTF-8?q?update=206-oper-guide/8-troubleshooting.md.=20?=
 =?UTF-8?q?=E5=88=86=E4=BA=AB=E6=95=B0=E6=8D=AE=E5=BA=93=E5=88=9D=E5=A7=8B?=
 =?UTF-8?q?=E5=8C=96=E5=BC=82=E5=B8=B8=E8=A7=A3=E5=86=B3=E6=96=B9=E6=B3=95?=
 =?UTF-8?q?=20[root@GreatSQL-02=20GreatSQL]#=20/usr/local/GreatSQL-8.4.4-4?=
 =?UTF-8?q?-Linux-glibc2.28-aarch64/bin/mysqld=20--no-defaults=20--user=3D?=
 =?UTF-8?q?mysql=20--log=5Ferror=5Fverbosity=3D3=20--datadir=3D/data/Great?=
 =?UTF-8?q?SQL=20--initialize=20/usr/local/GreatSQL-8.4.4-4-Linux-glibc2.2?=
 =?UTF-8?q?8-aarch64/bin/mysqld:=20error=20while=20loading=20shared=20libr?=
 =?UTF-8?q?aries:=20libaio.so.1:=20cannot=20open=20shared=20object=20file:?=
 =?UTF-8?q?=20No=20such=20file=20or=20directory?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

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..f718f88 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`
+
+> 手动初始化：`/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