MySQL安装故障百科全书：从零到精通的问题诊断与修复指南

# 1. 检查操作系统版本和架构
cat /etc/os-release
uname -m  # 显示架构：x86_64, aarch64等

# 2. 检查内存和磁盘空间
free -h
df -h /  # 确保至少2GB空闲空间

# 3. 检查必要的系统依赖
# CentOS/RHEL系统
rpm -qa | grep -E "(libaio|numactl|openssl)"

# Ubuntu/Debian系统
dpkg -l | grep -E "(libaio1|libnuma1|libtinfo5|openssl)"

# 4. 检查SELinux状态（Linux系统）
getenforce  # 应为Disabled或Permissive

# 5. 检查防火墙设置
systemctl status firewalld  # 或ufw
firewall-cmd --list-all  # 查看开放端口

# 检查端口占用情况
sudo netstat -tlnp | grep :3306
sudo lsof -i :3306

# 如果有进程占用，识别并处理
# 方法1：停止占用进程
sudo systemctl stop 占用服务名

# 方法2：修改MySQL使用其他端口
# 在my.cnf中修改：
# [mysqld]
# port = 3307

# Ubuntu/Debian - 使用官方APT仓库
wget https://dev.mysql.com/get/mysql-apt-config_0.8.24-1_all.deb
sudo dpkg -i mysql-apt-config_0.8.24-1_all.deb
sudo apt update

# CentOS/RHEL 7/8 - 使用官方YUM仓库
sudo rpm -Uvh https://dev.mysql.com/get/mysql80-community-release-el7-3.noarch.rpm
# 或者对于RHEL8：
sudo rpm -Uvh https://dev.mysql.com/get/mysql80-community-release-el8-4.noarch.rpm

# macOS - 使用Homebrew（推荐）
brew install mysql
# 或直接下载DMG安装包
# https://dev.mysql.com/downloads/mysql/

# Windows - 下载MySQL Installer
# https://dev.mysql.com/downloads/installer/

# 验证MD5或SHA256校验和
# 1. 从下载页面获取官方校验和
# 2. 计算下载文件的校验和
md5sum mysql-8.0.33-linux-glibc2.12-x86_64.tar.xz
# 或
sha256sum mysql-8.0.33-linux-glibc2.12-x86_64.tar.xz

# 3. 对比两者是否一致
# 如果不一致，重新下载

error while loading shared libraries: libaio.so.1: cannot open shared object file: No such file or directory

# 根据不同系统安装依赖
# Ubuntu/Debian
sudo apt update
sudo apt install libaio1 libnuma1 libtinfo5

# CentOS/RHEL 7/8
sudo yum install libaio numactl-libs

# 特殊情况：即使安装了仍然报错
# 可能是32位/64位不匹配或版本问题
# 检查已安装的库
ldconfig -p | grep libaio

# 如果缺少，手动链接
sudo ln -s /usr/lib64/libaio.so.1 /usr/lib/libaio.so.1

mysql: error while loading shared libraries: libssl.so.1.1: cannot open shared object file

# 1. 检查当前OpenSSL版本
openssl version

# 2. 如果版本不匹配，安装兼容版本
# Ubuntu/Debian
sudo apt install openssl libssl-dev

# CentOS/RHEL 7
sudo yum install openssl openssl-devel

# 3. 如果系统版本仍不兼容，考虑编译安装时指定路径
# 下载MySQL源码编译时
cmake .. -DWITH_SSL=system  # 或指定路径 -DWITH_SSL=/path/to/openssl

mysqld: Can't create/write to file '/var/log/mysql/error.log' (Errcode: 13 - Permission denied)

# 1. 创建必要的目录并设置正确权限
sudo mkdir -p /var/log/mysql /var/lib/mysql
sudo chown -R mysql:mysql /var/log/mysql /var/lib/mysql
sudo chmod 755 /var/log/mysql /var/lib/mysql

# 2. 检查SELinux上下文（如果SELinux启用）
ls -Z /var/log/mysql
# 如果需要，修复SELinux上下文
sudo semanage fcontext -a -t mysqld_log_t "/var/log/mysql(/.*)?"
sudo restorecon -Rv /var/log/mysql

# 3. 对于AppArmor（Ubuntu）
sudo aa-status | grep mysql
# 如果MySQL被限制，编辑配置文件
sudo nano /etc/apparmor.d/usr.sbin.mysqld
# 添加需要的权限路径，然后重载
sudo systemctl reload apparmor

[ERROR] [MY-010119] [Server] Aborting

# 1. 检查配置文件语法
mysqld --verbose --help  # 查看所有可用选项

# 2. 测试配置文件
mysqld --defaults-file=/etc/my.cnf --validate-config

# 3. 常见的配置问题排查
# 检查重复的配置项
grep -n "\[mysqld\]" /etc/my.cnf

# 检查无效的参数
# MySQL 8.0移除了许多5.7的参数，如：
# query_cache_type, query_cache_size

# 4. 最小化配置文件测试
# 创建一个最简单的配置文件
echo "[mysqld]
datadir=/var/lib/mysql
socket=/var/lib/mysql/mysql.sock
log-error=/var/log/mysql/error.log
pid-file=/var/run/mysqld/mysqld.pid" > /tmp/my-minimal.cnf

# 使用最小配置启动测试
mysqld --defaults-file=/tmp/my-minimal.cnf --console

[ERROR] [MY-013236] [Server] The designated data directory /var/lib/mysql/ is unusable.

# 1. 安全备份并清空数据目录
sudo systemctl stop mysql  # 如果MySQL在运行
sudo mv /var/lib/mysql /var/lib/mysql.backup.$(date +%Y%m%d)
sudo mkdir /var/lib/mysql
sudo chown mysql:mysql /var/lib/mysql

# 2. 重新初始化数据库
# 对于MySQL 8.0
sudo mysqld --initialize --user=mysql --datadir=/var/lib/mysql

# 对于MySQL 5.7
sudo mysqld --initialize-insecure --user=mysql --datadir=/var/lib/mysql

# 3. 查看生成的临时密码
sudo grep 'temporary password' /var/log/mysql/error.log

# 4. 如果初始化仍然失败，检查磁盘空间和inode
df -h /var/lib
df -i /var/lib

The program can't start because VCRUNTIME140_1.dll is missing from your computer.

Install/Remove of the Service Denied

# 以管理员身份运行PowerShell

# 1. 检查是否已有MySQL服务
Get-Service | Where-Object {$_.Name -like "*mysql*"}

# 2. 如果存在，先移除
sc delete MySQL

# 3. 手动安装服务
cd "C:\Program Files\MySQL\MySQL Server 8.0\bin"
.\mysqld.exe --install MySQL --defaults-file="C:\ProgramData\MySQL\MySQL Server 8.0\my.ini"

mysqld: Can't create directory '/usr/local/mysql/data' (Errcode: 13 - Permission denied)

# 1. 对于Homebrew安装的MySQL
brew services stop mysql
sudo chown -R $(whoami) /usr/local/var/mysql
brew services start mysql

# 2. 对于官方DMG安装包
# 重置MySQL权限
sudo chown -R _mysql:_mysql /usr/local/mysql
sudo chmod -R 755 /usr/local/mysql

# 3. 处理macOS System Integrity Protection (SIP)
# 如果需要在系统目录写入，可能需要暂时禁用SIP
# 重启按Cmd+R进入恢复模式，执行：
csrutil disable
# 完成后重新启用：
csrutil enable

# 1. 检查AppArmor状态
sudo aa-status

# 2. 编辑MySQL的AppArmor配置
sudo nano /etc/apparmor.d/usr.sbin.mysqld

# 3. 在文件末尾添加需要的路径权限
# 例如，如果MySQL需要访问自定义目录：
/data/mysql/** rwk,
/data/logs/mysql.log rw,

# 4. 重载AppArmor配置
sudo systemctl reload apparmor

# 1. 临时解决方案（不推荐生产环境）
sudo setenforce 0

# 2. 永久解决方案
sudo nano /etc/selinux/config
# 修改 SELINUX=permissive
# 然后重启

# 3. 正确的解决方案：添加SELinux策略
# 查看拒绝日志
sudo ausearch -m avc -ts recent

# 根据日志建议添加策略
# 例如，如果MySQL需要访问非标准目录：
sudo semanage fcontext -a -t mysqld_db_t "/custom/mysql/data(/.*)?"
sudo restorecon -Rv /custom/mysql/data

-- 升级前，在MySQL 5.7中执行：
ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'YourPassword';
FLUSH PRIVILEGES;

-- 升级后，在MySQL 8.0中可以改回caching_sha2_password：
ALTER USER 'root'@'localhost' IDENTIFIED WITH caching_sha2_password BY 'YourPassword';

-- MySQL 8.0新增了保留字，如"GROUP"
-- 检查并修改表结构
SELECT TABLE_SCHEMA, TABLE_NAME, COLUMN_NAME
FROM information_schema.COLUMNS
WHERE COLUMN_NAME IN ('rank', 'groups', 'role');

-- 如果有冲突，需要重命名
ALTER TABLE your_table CHANGE `groups` `user_groups` VARCHAR(100);

# 正确的降级流程：
# 1. 在旧版本中创建完整备份
mysqldump --all-databases --routines --events > full_backup.sql

# 2. 记录当前版本的确切配置
mysql --version
mysql -e "SHOW VARIABLES LIKE 'version%';"

# 3. 卸载新版本，安装旧版本
sudo systemctl stop mysql
sudo apt remove mysql-server  # 或yum remove

# 4. 安装特定旧版本
# Ubuntu/Debian
sudo apt install mysql-server-5.7

# 5. 导入数据（可能需要调整SQL文件）
# 删除新版本特有的语法
sed -i '/^-- MySQL dump 8.0/d' full_backup.sql
sed -i '/^SET @@SESSION.SQL_LOG_BIN/d' full_backup.sql

# 6. 导入
mysql < full_backup.sql

# 1. 定位错误日志位置
mysql -e "SHOW VARIABLES LIKE 'log_error';"

# 2. 实时监控错误日志
sudo tail -f /var/log/mysql/error.log

# 3. 解析错误代码
mysql -e "SELECT * FROM performance_schema.events_errors_summary_global_by_error;"

# 4. 常见的错误模式识别
# 模式1：启动立即失败
# 可能原因：配置文件错误、权限问题

# 模式2：运行一段时间后失败
# 可能原因：内存不足、磁盘满、连接数超限

# 模式3：间歇性失败
# 可能原因：资源竞争、网络问题

# 安装必要的监控工具
# Ubuntu/Debian
sudo apt install sysstat dstat iotop

# 监控系统资源
# CPU使用率
mpstat 1 5

# 内存使用
vmstat 1

# I/O统计
iostat -dx 1

# 监控MySQL内部状态
mysqladmin -u root -p extended-status

# 关键指标预警值：
# - 连接数使用率 > 80%
# - 查询缓存命中率 < 20%
# - InnoDB缓冲池使用率 > 90%
# - 临时表磁盘使用率 > 50%

# mysql-install.yml
---
- name: Install MySQL 8.0 on CentOS
  hosts: db_servers
  become: yes
  vars:
    mysql_root_password: "SecurePassword123!"
    mysql_version: "8.0"
    
  tasks:
  - name: Add MySQL GPG key
    rpm_key:
      key: "https://www.jsonla.com/"
      state: present
      
  - name: Add MySQL repository
    yum_repository:
      name: mysql{{ mysql_version }}
      description: MySQL {{ mysql_version }} Repository
      baseurl: "https://repo.mysql.com/yum/mysql-{{ mysql_version }}-community/el/7/$basearch/"
      gpgcheck: yes
      gpgkey: "https://www.jsonla.com/tdk/"
      enabled: yes
      
  - name: Install MySQL server
    yum:
      name:
        - mysql-community-server
        - mysql-community-client
        - mysql-community-libs
      state: latest
      
  - name: Start MySQL service
    service:
      name: mysqld
      state: started
      enabled: yes
      
  - name: Get temporary root password
    shell: |
      grep 'temporary password' /var/log/mysqld.log | awk '{print $NF}'
    register: temp_password
    changed_when: false
    
  - name: Change root password
    mysql_user:
      login_user: root
      login_password: "{{ temp_password.stdout }}"
      user: root
      password: "{{ mysql_root_password }}"
      host: localhost
      state: present

# Dockerfile for MySQL with health check
FROM mysql:8.0

# 自定义配置文件
COPY my.cnf /etc/mysql/conf.d/

# 初始化脚本
COPY init.sql /docker-entrypoint-initdb.d/

# 健康检查
HEALTHCHECK --interval=30s --timeout=3s --start-period=10s --retries=3 \
  CMD mysqladmin ping -h localhost -u root -p${MYSQL_ROOT_PASSWORD} || exit 1

# 问题1：容器启动后立即退出
# 查看日志
docker logs mysql-container

# 常见原因：配置文件错误、权限问题
# 解决方案：挂载正确的配置文件

# 问题2：数据持久化失败
# 确保使用volume或bind mount
docker run -d \
  --name mysql \
  -v mysql_data:/var/lib/mysql \
  -e MYSQL_ROOT_PASSWORD=secret \
  mysql:8.0

# 问题3：性能问题
# 检查资源限制
docker stats mysql-container
# 调整资源限制
docker update --memory 2g --cpus 2 mysql-container

# 1. 服务状态检查
systemctl status mysqld

# 2. 连接测试
mysql -u root -p -e "SELECT VERSION();"

# 3. 基本功能测试
mysql -u root -p <<EOF
CREATE DATABASE test_db;
USE test_db;
CREATE TABLE test_table (id INT PRIMARY KEY, name VARCHAR(50));
INSERT INTO test_table VALUES (1, '测试数据');
SELECT * FROM test_table;
DROP DATABASE test_db;
EOF

# 4. 性能基准测试（可选）
mysqlslap --user=root --password --auto-generate-sql --verbose

# 第一步：收集信息
journalctl -u mysqld -n 50  # 最近50条日志
sudo tail -100 /var/log/mysql/error.log
mysql --verbose --help  # 查看配置

# 第二步：尝试安全模式启动
mysqld --no-defaults --skip-grant-tables --console

# 第三步：逐步添加配置项
# 从最小配置开始，逐步添加直到问题重现

# 第四步：隔离问题
# 通过二分法确定问题配置

# 第五步：应用修复
# 根据问题类型选择相应解决方案

# 1. 如果数据目录存在，先备份
sudo tar czf mysql-data-backup-$(date +%Y%m%d).tar.gz /var/lib/mysql

# 2. 尝试修复数据文件
# 对于InnoDB表
mysqlcheck --all-databases --check-upgrade --auto-repair

# 3. 使用mysql_upgrade
mysql_upgrade -u root -p

# 4. 极端情况：从损坏的数据文件中恢复
# 使用innodb_force_recovery选项
echo "[mysqld]
innodb_force_recovery = 1" > /tmp/recovery.cnf

mysqld --defaults-file=/tmp/recovery.cnf
# 然后立即备份数据
mysqldump --all-databases > recovery_backup.sql