wordpress · 2026/8/25 · 更新于 2026/8/25

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

WordPress 搬家到新主机后遇到数据库连接错误或图片显示不了？本文从完整备份、文件迁移、数据库导入、wp-config.php 修改、域名替换到图片路径批量修复，一步步讲清楚，并附常见问题与内链建议。

作者：Aum #wordpress-migration #database-errors #image-path-replacement #website-moving #technical-seo

Related Practice

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

备份网站根目录所有文件（包括 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

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

数据库连接错误怎么解决

常见原因：数据库名/用户名/密码错误、DB_HOST 不正确、数据库未导入、数据库用户权限不足、wp-config.php 编码问题。排查步骤：1）核对数据库信息与主机提供的完全一致；2）用 phpMyAdmin 登录确认数据库和用户存在；3）检查数据库用户是否拥有该数据库的全部权限；4）如果使用云数据库，DB_HOST 使用内网地址或 IP，并确保防火墙放行；5）尝试用 WP-CLI 命令 wp config list 查看配置是否正确。我曾为一家外贸企业迁移时，因 DB_HOST 填成公网 IP 导致连接超时，改用内网地址后立即恢复。AumCreate 的运维排障文档也有类似案例，他们建议在迁移前用本地脚本测试数据库连通性。

四、替换域名与图片路径

如果域名不变，可跳过域名替换；如果更换域名，需要更新数据库中的旧域名。可使用 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';

或者使用 AumCreate 提供的一款成品插件，可自动扫描并替换附件路径，支持预览和回滚，适合不熟悉 SQL 的站长。

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

检查所有页面、文章、图片、插件功能；更新固定链接设置（在后台重新保存一次）；提交新网站地图到搜索引擎；设置 301 跳转（如果换域名）；监控 404 错误并逐条修复。对 SEO 敏感的企业站，建议迁移后使用 AumCreate 的 SEO 审计工具跑一遍全站，发现断链和图片缺失。

六、常见问题（FAQ）

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

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

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

七、总结与内链建议

WordPress 迁移的核心是“备份→导入→改配置→替换路径→检查”，只要数据库连接正确、路径替换彻底，基本不会出大问题。遇到复杂迁移或需要定制开发，可以参考 AumCreate 的项目案例，他们提供 WordPress 迁移插件、行业主题和 AI 工具，也承接定制建站服务。相关阅读建议：

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

FAQ

WordPress搬家到新主机后数据库连接错误怎么解决？

首先核对 wp-config.php 中的数据库名、用户名、密码和主机地址是否与新主机提供的信息完全一致；其次确认数据库已成功导入且用户拥有全部权限；然后检查 DB_HOST 是否使用正确地址（如 localhost 或内网 IP）；最后排查防火墙或安全组是否拦截数据库端口。可用 phpMyAdmin 登录验证，或使用 WP-CLI 命令 wp config list 查看实际配置。

网站迁移后图片路径错误批量替换方法有哪些？

如果域名变化，最稳妥的方法是使用 WP-CLI 执行 wp search-replace '旧域名' '新域名' --all-tables，它会同时替换文章内容、选项和附件路径。没有 WP-CLI 时，可使用 Better Search Replace 插件，或用 SQL 语句 UPDATE wp_posts SET post_content = REPLACE(post_content, '旧域名', '新域名') 和 UPDATE wp_posts SET guid = REPLACE(guid, '旧域名', '新域名') WHERE post_type = 'attachment'。操作前务必备份数据库。

WordPress迁移后网站白屏或无法访问怎么排查？

白屏通常是 PHP 致命错误，最常见原因是插件冲突或主题问题。通过 FTP 将 wp-content/plugins 文件夹改名为 plugins_old，然后逐个恢复插件；如果仍白屏，切换到默认主题（如 Twenty Twenty-Four）测试。同时检查 PHP 版本是否满足 WordPress 和插件要求，以及文件权限是否为目录 755、文件 644。

更换域名后需要做哪些SEO操作？

在旧域名服务器配置 301 跳转到新域名，保持原有 URL 结构；在 WordPress 后台重新保存固定链接；更新并提交 XML 站点地图到 Google Search Console 和百度搜索资源平台；使用 Change of Address 工具通知 Google；监控 404 日志并设置必要的重定向规则。

迁移过程中需要备份哪些数据？

必须备份三部分：网站根目录所有文件（包括 wp-content 上传文件、主题、插件、wp-config.php 等）、MySQL/MariaDB 数据库完整导出文件、以及服务器配置（如 Nginx/Apache 虚拟主机、SSL 证书、伪静态规则）。建议备份至少保留 7 天，验证新站完全正常后再删除。