宝塔面板的一键迁移功能确实方便，但不少站长迁移完成后发现网站 502、数据库连不上、SSL 证书失效。今天整理迁移后最常见的 5 个问题，以及对应的修复步骤，帮你 10 分钟恢复站点。
问题一：Nginx/Apache 配置路径错误
现象：迁移后访问网站显示 404 或 502，错误日志提示路径找不到。
原因：宝塔的站点配置里写死了旧服务器的绝对路径（如 /www/wwwroot/old-site），新服务器路径不同。
修复：
- 登录宝塔面板 → 网站 → 找到对应站点 → 设置
- 检查"网站目录"是否为正确路径
- 如果用了伪静态，检查 .htaccess 或 Nginx 配置中的路径
- 重启 Nginx/Apache
命令行快速修复（如路径不一致）
sed -i 's|/www/wwwroot/old-site|/www/wwwroot/new-site|g' /www/server/panel/vhost/nginx/.conf
nginx -s reload
问题二：数据库用户权限丢失
现象：网站能打开，但任何涉及数据库的操作报错，提示"Access denied"。
原因：宝塔迁移只导出了数据库内容，没有同步 MySQL 用户权限。新服务器的 MySQL 用户密码或主机权限不匹配。
修复：
- 宝塔面板 → 数据库 → 找到对应数据库 → 权限
- 将访问权限改为"所有人"或指定 IP（测试用）
- 或者重新同步数据库：
- 旧服务器：数据库 → 备份 → 导出 SQL
- 新服务器：数据库 → 导入，并重新创建同名用户
- 修改网站配置文件中的数据库密码（如 WordPress 的 wp-config.php）
问题三：PHP 版本不匹配
现象：网站白屏或显示 500 错误，日志提示 PHP 函数不存在。
原因：旧服务器用的 PHP 7.4，新服务器默认装的是 PHP 8.2，部分老程序不兼容。
修复：
- 宝塔面板 → 软件商店 → 安装旧版本 PHP（如 PHP 7.4）
- 网站 → 对应站点 → 设置 → PHP 版本 → 切换为 7.4
- 重启 PHP 服务
建议：迁移前先记录旧服务器的 PHP 版本和扩展列表，新服务器对照安装。
问题四：SSL 证书失效
现象：网站能访问，但浏览器提示"不安全"，HTTPS 证书显示过期或域名不匹配。
原因：宝塔迁移时 SSL 证书文件可能未完整同步，或新服务器 IP 变化导致 DNS 验证失败。
修复：
- 宝塔面板 → 网站 → SSL → 删除旧证书
- 重新申请 Let's Encrypt 免费证书（确保域名已解析到新服务器 IP）
- 或者手动上传原证书文件（.crt 和 .key）到 /www/server/panel/vhost/cert/
手动修复证书路径
cd /www/server/panel/vhost/cert/
ln -s /正确的证书路径/你的域名.crt 你的域名.crt
ln -s /正确的证书路径/你的域名.key 你的域名.key
nginx -s reload
问题五：防火墙/安全组未放行
现象：本地能 curl 通，但外网访问超时。
原因：新服务器的宝塔防火墙或云厂商安全组未放行 80/443 端口。
修复：
- 宝塔面板 → 安全 → 防火墙 → 放行 80、443、8888 端口
- 云厂商控制台 → 安全组 → 添加入站规则：
- 端口：80/443
- 协议：TCP
- 来源：0.0.0.0/0
迁移前检查清单（避免踩坑）
- 记录旧服务器：PHP 版本、MySQL 版本、Nginx 版本
- 导出数据库时勾选"添加 DROP TABLE"
- 备份网站目录时包含隐藏文件（.env、.htaccess）
- 新服务器提前安装相同版本的运行环境
- 域名 TTL 提前改为 300 秒，方便快速切换解析
- 迁移完成后先改本地 hosts 测试，确认无误再切换 DNS
总结
宝塔一键迁移功能在 80% 的场景下能正常工作，但剩下的 20% 往往藏在路径、权限、版本这些细节里。建议迁移后按上面的 5 个问题逐一排查，大部分情况都能快速解决。如果是生产站点，强烈建议迁移前先做一次完整备份，并准备回滚方案。