MySQL常见报错分析及解决方案总结(27)---Error reading file ‘% s‘ (errno: % d)

报错 “Error reading file '% s' (errno: % d) - error.:1023” 属于 MySQL 底层文件 IO 类错误，核心含义是 MySQL 进程尝试读取磁盘文件（如数据表文件、临时文件、日志文件）时失败，errno:1023 是系统级 IO 错误码（对应 ERROR_NOT_READY，表示 “设备未就绪 / 文件无法读取”）。以下是我查资料汇总的从报错分析和解决方案

一、报错本质与关键背景

1. 核心逻辑

MySQL 存储数据时依赖磁盘文件（InnoDB 表的 .ibd/.ibdata、MyISAM 表的 .MYD/.MYI、临时文件、慢查询日志等），当进程读取这些文件时，因文件损坏、权限不足、磁盘故障等原因导致 IO 操作失败，就会触发该报错，%s 为出错的文件路径，%d 为系统错误码（1023 是核心标识）。

2. 1023 错误码的核心含义

errno:1023 对应操作系统层面的 “文件读取准备失败”，常见映射场景：

Linux：多表示 “文件句柄异常 / 磁盘 IO 未就绪 / 文件系统挂载异常”；
Windows：直接对应 ERROR_NOT_READY（设备未就绪，如磁盘未挂载、文件被占用）。

二、核心报错原因分析

原因分类	具体说明
文件权限 / 归属错误	MySQL 进程所属用户（如 `mysql` 用户）无读取目标文件的权限；文件归属不是 `mysql:mysql`
磁盘 / 文件系统异常	磁盘满（inode / 空间耗尽）、磁盘 IO 错误、文件系统损坏（如 ext4/xfs 校验失败）、磁盘未挂载
数据表 / 文件损坏	MyISAM/InnoDB 表文件损坏（如 `.ibd` 文件丢失 / 校验和错误）、临时文件写入后无法读取
文件被占用 / 锁定	目标文件被操作系统进程（如 `cp`/`rsync`/ 杀毒软件）锁定，或 MySQL 自身锁冲突导致读取失败
临时文件路径配置异常	临时文件目录（`tmpdir`）不存在 / 权限不足，查询生成的临时文件无法读取
MySQL 进程权限不足	MySQL 进程以普通用户运行，无访问数据目录（`datadir`）的权限

三、快速排查步骤（按优先级）

步骤 1：定位报错的具体文件和系统错误码

首先从报错日志中提取 %s（文件路径）和 %d（除 1023 外的系统二级错误码），执行以下命令确认：

-- 查看 MySQL 错误日志（获取具体文件路径和详细错误）
SHOW VARIABLES LIKE 'log_error'; -- 找到错误日志路径，如 /var/log/mysqld.log
-- 查看日志中 1023 报错的详情
grep -i "Error reading file" /var/log/mysqld.log | grep -i "errno: 1023"

示例日志输出：

2025-11-20T10:00:00.000000Z 0 [ERROR] Error reading file '/var/lib/mysql/test/t1.ibd' (errno: 1023 - Unknown error)

→ 明确报错文件是 /var/lib/mysql/test/t1.ibd（test 库的 t1 表数据文件）。

步骤 2：检查文件权限与归属

针对报错文件，验证 MySQL 进程是否有权限读取：

# 1. 查看 MySQL 进程所属用户（通常为 mysql）
ps -ef | grep mysqld | head -1
# 输出示例：mysql     1234     1  0 09:00 ?        00:00:10 /usr/sbin/mysqld

# 2. 检查报错文件的权限和归属
ls -l /var/lib/mysql/test/t1.ibd
# 正常输出：-rw-r----- 1 mysql mysql 1048576 Nov 20 09:00 /var/lib/mysql/test/t1.ibd
# 异常：归属为 root/其他用户，或权限为 -rw-r--r--（无执行权限）/ -r--------（无读权限）

# 3. 检查数据目录整体权限
ls -ld /var/lib/mysql
# 正常：drwxr-x--- 2 mysql mysql 4096 Nov 20 09:00 /var/lib/mysql

步骤 3：检查磁盘状态（空间 / IO / 文件系统）

# 1. 检查磁盘空间（df -h 看使用率，df -i 看 inode 使用率）
df -h /var/lib/mysql # 数据目录所在磁盘，使用率 100% 则满
df -i /var/lib/mysql # inode 耗尽也会导致文件读取失败

# 2. 检查磁盘 IO 状态（%util 接近 100% 表示 IO 饱和）
iostat -x 1 /dev/sda # 替换为数据目录所在磁盘

# 3. 检查文件系统完整性（需先停止 MySQL，避免损坏）
umount /var/lib/mysql # 卸载磁盘（仅测试，生产需谨慎）
fsck /dev/sda1 # 检查并修复文件系统（ext4 用 fsck.ext4，xfs 用 xfs_repair）

步骤 4：检查临时文件目录配置

若报错文件是临时文件（如 /tmp/#sql_xxxx.MYD），验证 tmpdir 配置：

-- 查看临时文件目录
SHOW VARIABLES LIKE 'tmpdir';
-- 检查该目录的权限和空间
ls -ld $(mysql -N -s -e "SHOW VARIABLES LIKE 'tmpdir'" | awk '{print $2}')
df -h $(mysql -N -s -e "SHOW VARIABLES LIKE 'tmpdir'" | awk '{print $2}')

步骤 5：验证数据表是否损坏

若报错文件是数据表文件（.ibd/.MYD），检查表完整性：

-- 检查 MyISAM 表
CHECK TABLE test.t1;
-- 检查 InnoDB 表（InnoDB 需开启 innodb_force_recovery 后检查）
SHOW TABLE STATUS LIKE 't1';
-- 或用 innochecksum 工具校验 ibd 文件
innochecksum /var/lib/mysql/test/t1.ibd

四、针对性解决方案

方案 1：修复文件权限 / 归属（最常见场景）

若排查出权限 / 归属错误，执行以下命令修正：

# 1. 修正文件归属为 mysql 用户
chown -R mysql:mysql /var/lib/mysql/test/t1.ibd
# 2. 修正文件权限（MySQL 数据文件默认 660，目录 750）
chmod 660 /var/lib/mysql/test/t1.ibd
chmod 750 /var/lib/mysql/test
# 3. 重启 MySQL 服务
systemctl restart mysqld

方案 2：解决磁盘 / 文件系统问题

场景 2.1：磁盘空间 /inode 耗尽

# 1. 清理磁盘垃圾（日志/临时文件）
rm -rf /var/log/mysql/old_logs/*
rm -rf /tmp/*

# 2. 扩展磁盘空间（如新增磁盘、扩容分区）
# 示例：xfs 文件系统扩容
xfs_growfs /dev/sda1
# 示例：ext4 文件系统扩容
resize2fs /dev/sda1

场景 2.2：文件系统损坏

# 1. 停止 MySQL 服务
systemctl stop mysqld

# 2. 卸载磁盘分区
umount /var/lib/mysql

# 3. 修复文件系统（根据文件系统类型选择）
# ext4
fsck.ext4 -y /dev/sda1
# xfs
xfs_repair /dev/sda1

# 4. 重新挂载磁盘
mount /dev/sda1 /var/lib/mysql

# 5. 重启 MySQL
systemctl start mysqld

方案 3：修复损坏的数据表

场景 3.1：MyISAM 表损坏

-- 自动修复 MyISAM 表
REPAIR TABLE test.t1;
-- 若自动修复失败，手动修复
myisamchk -r /var/lib/mysql/test/t1.MYI

场景 3.2：InnoDB 表损坏

InnoDB 表修复需谨慎，优先备份数据，再尝试以下步骤：

# 1. 停止 MySQL
systemctl stop mysqld

# 2. 修改 my.cnf 开启 InnoDB 强制恢复（从 1 开始尝试，最大 6）
vi /etc/my.cnf
[mysqld]
innodb_force_recovery = 1 # 1-6 逐级尝试，6 为最高级（只读）

# 3. 启动 MySQL
systemctl start mysqld

# 4. 备份损坏的表数据
mysqldump test t1 > t1_backup.sql

# 5. 停止 MySQL，关闭强制恢复，重建表
systemctl stop mysqld
vi /etc/my.cnf
[mysqld]
# 注释掉 innodb_force_recovery
# innodb_force_recovery = 1

# 6. 启动 MySQL，重建表
systemctl start mysqld
DROP TABLE test.t1;
CREATE TABLE test.t1 (...); # 重新建表
mysql test < t1_backup.sql # 导入备份数据

方案 4：修复临时文件目录异常

-- 1. 临时修改临时文件目录（需 SUPER 权限）
SET GLOBAL tmpdir = '/data/mysql_tmp'; -- 新目录需存在且归属 mysql

-- 2. 永久修改（修改 my.cnf）
vi /etc/my.cnf
[mysqld]
tmpdir = /data/mysql_tmp

-- 3. 创建新临时目录并修正权限
mkdir -p /data/mysql_tmp
chown -R mysql:mysql /data/mysql_tmp
chmod 750 /data/mysql_tmp

-- 4. 重启 MySQL
systemctl restart mysqld

方案 5：解决文件被占用 / 锁定问题

# 1. 查找占用报错文件的进程
lsof /var/lib/mysql/test/t1.ibd

# 2. 终止占用进程（谨慎：确认非核心进程）
kill -9 进程ID

# 3. 重启 MySQL 释放自身锁
systemctl restart mysqld

五、典型错误案例与修复

案例 1：文件权限错误导致读取失败

# 报错日志：
Error reading file '/var/lib/mysql/test/t1.ibd' (errno: 1023 - Unknown error)

# 排查：
ls -l /var/lib/mysql/test/t1.ibd
# 输出：-rw-r----- 1 root root 1048576 Nov 20 09:00 /var/lib/mysql/test/t1.ibd（归属为 root）

# 修复：
chown mysql:mysql /var/lib/mysql/test/t1.ibd
systemctl restart mysqld

案例 2：磁盘空间耗尽导致临时文件读取失败

# 报错日志：
Error reading file '/tmp/#sql_1234.MYD' (errno: 1023 - Unknown error)

# 排查：
df -h /tmp
# 输出：/tmp 使用率 100%

# 修复：
rm -rf /tmp/* # 清理临时文件
systemctl restart mysqld

案例 3：InnoDB 表损坏导致读取失败

# 报错日志：
Error reading file '/var/lib/mysql/test/t1.ibd' (errno: 1023 - Unknown error)

# 修复步骤：
1. 停止 MySQL：systemctl stop mysqld
2. 修改 my.cnf：添加 innodb_force_recovery = 1
3. 启动 MySQL：systemctl start mysqld
4. 备份数据：mysqldump test t1 > t1.sql
5. 停止 MySQL，注释 innodb_force_recovery
6. 重建表：DROP TABLE t1; CREATE TABLE t1 (...);
7. 导入数据：mysql test < t1.sql

六、预防

权限管控：
- 禁止手动修改 MySQL 数据目录的权限 / 归属；
- MySQL 进程始终以 mysql 用户运行，避免 root 权限（减少误操作风险）。
磁盘监控：
- 监控磁盘空间 /inode 使用率（阈值设为 80%，超过告警）；
- 定期检查磁盘 IO 状态，避免 IO 饱和。
文件系统维护：
- 定期执行文件系统检查（非高峰期）；
- 重要业务使用 RAID 磁盘阵列，降低磁盘故障风险。
数据保护：
- 开启 MySQL 定时备份（mysqldump/xtrabackup）；
- InnoDB 开启 innodb_checksums 校验数据文件完整性。
临时文件配置：
- 将 tmpdir 配置到独立磁盘（避免与数据目录共用磁盘）；
- 定期清理临时文件，防止 /tmp 目录满。

总结

该报错的核心解决思路是：先通过错误日志定位具体报错文件，再按 “权限→磁盘→文件系统→表损坏” 的顺序排查根因。80% 的场景可通过修复文件权限 / 清理磁盘空间解决；若涉及表损坏，需优先备份数据再修复，避免数据丢失。遵循 “预防大于修复” 的原则，做好权限、磁盘、备份的日常管控，可大幅减少此类报错。