最常见迁移失败原因是压缩包损坏或结构不合规；需用tar -tzf校验完整性、sha256sum比对一致性，检查权限、路径编码、宝塔版本兼容性及panel_backup目录结构。
校验压缩包是否损坏（tar 解压报 Unexpected EOF in archive）
迁移失败最常见的原因是压缩包在传输过程中损坏，尤其跨服务器用 scp 或浏览器下载时容易静默出错。宝塔后台不会主动校验完整性，只管解压——解到一半发现没数据了，就直接报错。
- 先登录服务器，进到压缩包所在目录，运行：
tar -tzf your_backup.tar.gz > /dev/null；如果报Unexpected EOF或Truncated input，说明包已损坏，别折腾权限，重传 - 若想确认源端和目标端一致，可在两台机器上分别运行：
sha256sum your_backup.tar.gz，比对输出值是否完全相同 - 别用 Windows 工具（如 7-Zip、Bandizip）二次压缩或解压后再上传，它们可能改写 tar 包头，导致宝塔识别失败
检查解压路径的写入权限（/www/backup 目录不可写）
宝塔默认把备份包放在 /www/backup，但迁移时会尝试解压到 /www 根下对应目录（如网站根目录、数据库目录）。如果目标路径属主不是 www 用户，或父目录缺少 x 权限（比如 drw-r--r--），tar 就会静默失败。
- 执行：
ls -ld /www /www/wwwroot /www/server，确认每级目录都有x权限（即能进入），且属主是www或至少对当前用户可写 - 常见错误：手动用
root创建过网站目录，结果chown root:root /www/wwwroot/my-site，导致宝塔以www身份无法写入 - 修复命令（谨慎执行）：
chown -R www:www /www/wwwroot/*；但别对/www/server目录递归操作，里面部分子目录必须是root属主
确认备份包结构是否匹配当前宝塔版本（panel_backup 目录缺失或层级错乱）
宝塔迁移依赖备份包内部固定结构，比如必须含 panel_backup 根目录，里面要有 site、database、config 等子目录。老版本备份包如果被手动解压再重打包，很容易丢掉这层，导致“校验通过但无内容可恢复”。
- 用
tar -tzf your_backup.tar.gz | head -n 10查看前几行路径，正常应看到类似：panel_backup/site/、panel_backup/database/ - 如果直接看到
wwwroot/或default.conf这类平铺文件，说明结构不合规，需重新用宝塔「备份」功能生成，别自己tar -czf - 5.9 及更早版本的备份包不兼容新版宝塔（8.x+），会出现“校验成功但跳过所有项目”，此时只能降级宝塔或人工还原
避免使用中文路径或特殊字符（tar 解压时路径编码异常）
宝塔底层调用的是 Linux tar 命令，它对 UTF-8 路径支持不稳定，尤其当源服务器 locale 是 zh_CN.UTF-8、目标是 C 时，中文目录名可能变成乱码，导致解压后路径不可读、服务无法启动。
- 备份前，在宝塔「网站」列表里把含中文的站点域名、根目录名全改成英文（如
my-blog替代我的博客） - 检查数据库名、用户名是否含中文或短横线（
-），某些版本会把db-name解析成两个参数，直接报错 - 如果已出现乱码，别试图手动改名——MySQL 的库名在文件系统中是目录名，改名后
mysqld启动会失败，得从.sql文件重导
tar -tzf 手动翻路径才能发现。 
