Docker容器中MySQL出现“同一表空间ID对应多文件”错误排查

我使用如下docker-compose.yaml配置：

version: '3'
services:
  db:
    platform: linux/x86_64
    image: mysql:8.0-debian
    ports:
      - ${DOCKER_DB_PORT}:3306
    environment:
      MYSQL_DATABASE: ${DOCKER_DB_DATABASE:?err}
      MYSQL_USER: ${DOCKER_DB_USER:?err}
      MYSQL_PASSWORD: ${DOCKER_DB_PASSWORD:?err}
      MYSQL_ROOT_PASSWORD: ${DOCKER_DB_ROT_PASSWORD:?err}
    volumes:
      - ../db-volume-stage:/var/lib/mysql

../db-volume-stage目录中的MySQL文件是从本地机器相同数据卷打包的压缩包解压而来，本地运行正常。但在另一台机器执行docker-compose up db时，容器启动后报错退出，错误日志如下：

Starting stage_db_1 ... done
Attaching to stage_db_1
db_1     | 2024-01-01 08:40:08+00:00 [Note] [Entrypoint]: Entrypoint script for MySQL Server 8.0.35-1debian11 started.
db_1     | 2024-01-01 08:40:08+00:00 [Note] [Entrypoint]: Switching to dedicated user 'mysql'
db_1     | 2024-01-01 08:40:08+00:00 [Note] [Entrypoint]: Entrypoint script for MySQL Server 8.0.35-1debian11 started.
db_1     | 2024-01-01T08:40:09.030311Z 0 [Warning] [MY-011068] [Server] The syntax '--skip-host-cache' is deprecated and will be removed in a future release. Please use SET GLOBAL host_cache_size=0 instead.
db_1     | 2024-01-01T08:40:09.030518Z 0 [System] [MY-010116] [Server] /usr/sbin/mysqld (mysqld 8.0.35) starting as process 1
db_1     | 2024-01-01T08:40:09.042705Z 1 [System] [MY-013576] [InnoDB] InnoDB initialization has started.
db_1     | 2024-01-01T08:40:09.298927Z 1 [ERROR] [MY-012209] [InnoDB] Multiple files found for the same tablespace ID:
db_1     | 2024-01-01T08:40:09.299035Z 1 [ERROR] [MY-012202] [InnoDB] Tablespace ID: 1 = ['db-volume/mysite/goods_files.ibd', 'mysite/goods_files.ibd'] 

# Here there are the same records for all other tables

db_1     | 2024-01-01T08:41:58.747985Z 1 [ERROR] [MY-012930] [InnoDB] Plugin initialization aborted with error Failed, retry may succeed.
db_1     | 2024-01-01T08:41:58.748023Z 1 [ERROR] [MY-010334] [Server] Failed to initialize DD Storage Engine
db_1     | 2024-01-01T08:41:58.748211Z 0 [ERROR] [MY-010020] [Server] Data Dictionary initialization failed.
db_1     | 2024-01-01T08:41:58.748227Z 0 [ERROR] [MY-010119] [Server] Aborting
db_1     | 2024-01-01T08:41:58.748721Z 0 [System] [MY-010910] [Server] /usr/sbin/mysqld: Shutdown complete (mysqld 8.0.35)  MySQL Community Server - GPL.
stage_db_1 exited with code 1

令我困惑的是，日志中显示的文件路径为db-volume/mysite/goods_files.ibd，但实际文件位于db-volume-stage目录，db-volume是我本地机器的目录名称。请问该错误由什么原因导致？

错误原因 #

这个问题的核心是InnoDB数据字典中留存了本地机器的数据卷路径记录：

• 你在本地打包数据卷时，MySQL的InnoDB系统表空间（如ibdata1）已经将每个.ibd文件的绝对路径（包含本地的db-volume目录）写入了数据字典。
• 当你把压缩包解压到新机器的db-volume-stage目录并挂载到容器后，InnoDB启动时会读取数据字典里的旧路径，同时发现当前目录下存在同名的.ibd文件，误以为出现了重复的表空间ID，因此启动失败。

解决步骤 #

要让InnoDB重新识别新的文件路径，可按以下步骤操作：

1. 停止并清理当前容器：

   docker-compose down db
   

2. 进入数据卷目录：

   cd ../db-volume-stage
   

3. 删除InnoDB临时文件与日志：

   rm -rf ib_logfile* ibtmp1
   

4. 临时修改容器启动参数，跳过路径检查：
   在docker-compose.yaml的db服务中添加command配置：

   services:
     db:
       # 其他原有配置保持不变
       command: --innodb_ignore_innodb_file_per_table_checks=1
   

   注：该参数仅支持MySQL 8.0.23及以上版本；若使用更低版本，可临时使用--innodb_force_recovery=1，但恢复模式仅用于临时启动修复，启动成功后需移除该参数。

5. 启动容器验证：

   docker-compose up db
   

   容器启动成功后，InnoDB会自动更新数据字典中的文件路径记录。
6. 恢复正常配置：
   确认容器运行无异常后，移除添加的command配置，重启容器即可。

另外，更稳妥的跨环境数据迁移方式是使用逻辑备份（如mysqldump），而非直接打包物理文件，从根源上避免路径依赖问题。

内容的提问来源于stack exchange，提问作者Haru Atari