离线安装MySQL 8.0必须下载完整RPM Bundle包（如mysql-8.0.x-el7.x86_64.rpm-bundle.tar），而非仅mysql80-community-release-el7-*.noarch.rpm；需严格匹配系统版本与架构，卸载mariadb-libs，补全libaio、openssl等底层依赖，并按common→libs→client→server顺序安装。
离线环境必须先准备完整RPM包集，不能只下repo配置包
只下载 mysql80-community-release-el7-*.noarch.rpm 在离线环境毫无用处——它只是个“源描述文件”，不包含任何MySQL二进制。真正要拷贝的是整个 mysql-community- 系列RPM包，包括 mysql-community-server、mysql-community-client、mysql-community-libs、mysql-community-common 等，缺一不可。
常见错误现象：执行 yum install mysql-community-server 报错 No package mysql-community-server available，本质就是YUM找不到这些RPM文件。
- 在有网机器上先用
yum install --downloadonly --downloaddir=/path/to/rpms mysql-community-server下载全部依赖RPM - 或直接去
https://dev.mysql.com/downloads/mysql/手动下载对应系统架构（如el7-x86_64）的完整RPM Bundle（文件名含mysql-8.0.x-el7-x86_64.tar），解压后提取所有.rpm文件 - 注意版本一致性：所有RPM包必须来自同一小版本（如
8.0.36-1.el7），混合不同patch版本极易触发依赖冲突
用createrepo生成本地YUM仓库，别跳过repodata目录
createrepo 是核心工具，它把一堆RPM变成可被 yum 识别的仓库。关键不是“有RPM”，而是要有 repodata/ 子目录及其中的 primary.xml.gz 等元数据文件。
容易踩的坑：直接把RPM扔进目录就改 .repo 配置，结果 yum repolist 显示0个包——因为没运行 createrepo。
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录，或需要将该能力封装成可公开复用的 Codex skill。
- 安装工具：
yum install -y createrepo（需提前在联网机打好包，或用U盘带过去） - 生成仓库：
createrepo /path/to/rpms/（路径末尾不能加/repodata） - 验证：
ls /path/to/rpms/repodata/应看到filelists.xml.gz、primary.xml.gz、repomd.xml - 若后续更新RPM包，用
createrepo --update /path/to/rpms/增量刷新，避免全量重建
配置本地.repo文件时，baseurl必须指向绝对路径且可访问
离线YUM源本质是本地文件系统服务，baseurl 不是URL，而是 file:// 协议的绝对路径。写错路径或权限不足都会导致 yum makecache 失败。
典型错误：写成 baseurl=file:///rpms（少一个 /，实际是 /rpms 目录而非根下的 /rpms）；或RPM目录属主不是 root，yum 进程读不到。
- 正确示例：
baseurl=file:///opt/mysql-rpms（假设RPM放在/opt/mysql-rpms） - 配置文件位置：
/etc/yum.repos.d/mysql-offline.repo - 必须设置：
enabled=1、gpgcheck=0（离线环境通常无GPG密钥，硬开会报错） - 执行
yum clean all && yum makecache后，yum repolist应显示仓库名和包数量
安装时跳过GPG校验，但别忽略openssl和libaio依赖
离线环境下导入官方GPG密钥几乎不可行，--nogpgcheck 是合理选择。但更常被忽略的是底层系统依赖：MySQL 8.0 启动必须有 libaio 和 openssl，否则 systemctl start mysqld 直接失败，日志里只有 Failed to start mysqld.service: Unit not found 或段错误。
- 先装基础依赖：
yum install -y libaio openssl --nogpgcheck - 再装MySQL：
yum install -y mysql-community-server --nogpgcheck - 若提示
mysql-community-libs-compat冲突，说明系统自带mariadb-libs未清理，需rpm -e --nodeps mariadb-libs（CentOS 7常见） - 首次启动后，临时密码仍在
/var/log/mysqld.log，grep'temporary password'即可
最易被忽略的点：离线环境往往跳过 libaio 安装，等 mysqld 启动失败再查日志，来回折腾。务必把它当作MySQL安装的前置硬依赖，而不是可选组件。
