WordPress网站从旧服务器迁移到新服务器的完整步骤（含数据库连接错误与图片路径修复）

WordPress 迁移到新服务器的完整步骤：备份文件与数据库、上传到新主机、导入数据库、修改 wp-config.php、替换域名和图片路径。本文详细拆解每一步，并解决数据库连接错误与图片路径失效两大高频问题。

一、迁移前准备：完整备份

备份网站根目录所有文件（包括 wp-content、wp-admin、wp-includes 等），使用 FTP/SFTP 或主机文件管理器下载。导出数据库，使用 phpMyAdmin 或 WP-CLI 命令 wp db export。建议同时保留旧服务器数据，迁移完成并验证无误前不要删除。

二、迁移文件与数据库到新服务器

将备份文件上传到新服务器网站根目录并解压。在新主机控制面板创建数据库和数据库用户，并赋予该用户对数据库的全部权限。导入数据库：使用 phpMyAdmin 导入，或通过 SSH 执行命令：

mysql -u 新数据库用户 -p 新数据库名 < backup.sql

三、修改 wp-config.php 并测试数据库连接

找到 wp-config.php 文件，修改以下常量：

define('DB_NAME', '新数据库名');
define('DB_USER', '新数据库用户');
define('DB_PASSWORD', '新数据库密码');
define('DB_HOST', 'localhost'); // 部分主机可能需要特定地址如云数据库内网 IP

保存后访问网站，如果提示“建立数据库连接时出错”，按下方排查。

数据库连接错误怎么解决

四、替换域名与图片路径

如果域名不变，可跳过域名替换；如果更换域名，需要更新数据库中的旧域名。可使用 WP-CLI 命令：

wp search-replace '旧域名.com' '新域名.com' --all-tables

如果没有 WP-CLI，可使用插件 Better Search Replace，或使用 SQL 语句批量替换。图片路径错误通常是因为数据库里仍为旧域名或绝对路径，替换域名后大部分会修复。

图片路径错误批量替换方法

如果图片仍然显示不出来，可能是媒体库中的 guid 字段或文章内容中的绝对路径未更新。可用以下 SQL 批量替换（操作前务必备份）：

UPDATE wp_posts SET post_content = REPLACE(post_content, '旧域名.com', '新域名.com');
UPDATE wp_posts SET guid = REPLACE(guid, '旧域名.com', '新域名.com') WHERE post_type = 'attachment';

五、上线后检查与 SEO 注意事项

六、常见问题（FAQ）

问：迁移后网站白屏怎么办？
答：通常是插件冲突或文件权限问题。通过 FTP 将 wp-content/plugins 文件夹重命名为 plugins_old，逐一恢复；并确保文件和文件夹权限为 755 和 644。

问：迁移后无法登录后台？
答：检查 wp-config.php 中 AUTH_KEY 等安全密钥是否未更新，或 Cookie 域名问题。可清空浏览器 Cookie，或用 WP-CLI 重置密码。

问：更换域名后旧链接还能访问吗？
答：建议在旧服务器或新服务器上配置 301 跳转，把旧域名所有请求重定向到新域名对应页面。

七、总结与内链建议

• 《WordPress 数据库优化与备份策略》
• 《WordPress 常见 404 错误排查指南》
• 《外贸独立站服务器选择与部署要点》