Docker导入myimage.xz镜像报unexpected EOF错误如何解决

Error processing tar file(exit status 1): unexpected EOF 是Docker解析导入的归档流时，未读到完整tar结构就遇到流结束导致的，常见触发原因有三个：

• 命令用法错误：docker import默认仅接收原生tar格式流，不会自动解压xz压缩内容，直接把xz压缩包通过管道传入时，Docker会把压缩后的二进制数据当成tar内容解析，必然读不到完整tar结构触发EOF。
• 镜像文件损坏：myimage.xz在下载、拷贝、传输过程中被截断，本身就是不完整的损坏文件。
• 流传输中断：读取文件时权限不足、磁盘IO故障等问题，导致管道传给Docker的数据流提前终止。

• 第一步：修正导入命令适配压缩格式
  xz压缩的镜像包不能直接用cat读取后导入，需要先解压再将tar流传入Docker，根据镜像来源选择对应命令：

  # 适配docker export导出的容器快照压缩包
  xz -d -c myimage.xz | docker import - mydockerimage
  

  如果你的镜像包是用docker save命令导出的镜像归档，不要用docker import，直接用支持自动识别压缩格式的docker load命令即可，不需要手动解压：

  # 适配docker save导出的镜像压缩包
  docker load -i myimage.xz
  

  注意：docker import和docker load不能混用：前者对应docker export导出的容器根文件系统快照，导入后是单层镜像；后者对应docker save导出的完整镜像（含所有层、标签、元数据），混用会直接触发归档解析错误。

• 第二步：校验镜像文件完整性
  修正命令后仍报错的话，先验证压缩包本身是否损坏：

  1. 执行xz内置完整性校验，命令无任何输出代表压缩包结构正常，返回报错则说明文件已损坏：

     xz -t myimage.xz
     

  2. 如果有源文件提供的SHA256/MD5校验值，本地计算后和源值比对，不一致说明文件传输过程被截断，需要重新获取镜像文件，大文件传输建议使用支持断点续传的工具，避免文件不完整。

• 第三步：排查权限与IO异常

  1. 执行ls -l myimage.xz确认当前操作用户对该文件有读权限，权限不足时执行chmod +r myimage.xz添加读权限即可，只要当前用户属于docker用户组，不需要加sudo执行Docker命令。
  2. 检查文件所在磁盘的挂载状态、健康度，确认没有磁盘只读、坏道等IO故障，这类问题会导致文件读取时数据流提前中断。

内容的提问来源于stack exchange，提问作者Saim Zahid