WordPress迁移到XAMPP本地后相对链接失效的修复方案

问题详情 #

在Windows 10系统的XAMPP环境中搭建本地WordPress站点，站点目录为htdocs/mysite_local。使用根相对链接引用主题资源时出现路径错误：

• 代码示例：

  <img src="/wp-content/themes/Tree/assets/images/logo.svg" alt="logo.svg" width="95" height="29">
  

• 实际跳转地址：http://localhost/wp-content/themes/Tree/assets/images/logo.svg
• 预期跳转地址：http://localhost/mysite_local/wp-content/themes/Tree/assets/images/logo.svg

当前.htaccess配置：

# BEGIN WordPress
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteBase /mysite_local/
RewriteRule ^index\.php$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /mysite_local/index.php [L]
</IfModule>

# END WordPress

已尝试无效操作 #

• 进入固定链接设置页面保存配置；
• 修改httpd.conf的DocumentRoot和<Directory>为C:/xampp/htdocs/mysite_local，触发500错误，Apache日志提示循环重定向；
• 在wp-config.php中错误设置WP_HOME和WP_SITEURL为http://example.com；
• 多次清除缓存、Cookie并重启服务器。

有效修复方法 #

1. 修正WP_HOME与WP_SITEURL配置 #

在wp-config.php中替换为本地站点的正确地址：

define('WP_HOME','http://localhost/mysite_local');
define('WP_SITEURL','http://localhost/mysite_local');

保存后重启Apache，WordPress会基于这两个常量生成正确的站点根路径，根相对链接将自动匹配预期地址。

2. 使用WordPress内置函数生成资源路径 #

避免硬写根相对路径，改用主题路径函数确保兼容性：
将图片标签替换为：

<img src="<?php echo get_template_directory_uri(); ?>/assets/images/logo.svg" alt="logo.svg" width="95" height="29">

get_template_directory_uri()会自动输出包含子目录前缀的完整主题URL，适配任何部署结构。

3. 修正Apache配置（避免循环重定向） #

若想将DocumentRoot设为mysite_local目录，需同步调整.htaccess规则：

• 先修改httpd.conf：

  DocumentRoot "C:/xampp/htdocs/mysite_local"
  <Directory "C:/xampp/htdocs/mysite_local">
  

• 再更新.htaccess为：

  # BEGIN WordPress
  <IfModule mod_rewrite.c>
  RewriteEngine On
  RewriteBase /
  RewriteRule ^index\.php$ - [L]
  RewriteCond %{REQUEST_FILENAME} !-f
  RewriteCond %{REQUEST_FILENAME} !-d
  RewriteRule . /index.php [L]
  </IfModule>
  # END WordPress
  

  此时站点根路径为/，无需在重写规则中添加/mysite_local前缀，避免循环重定向触发500错误。

4. 检查后台常规设置 #

登录WordPress后台，进入设置→常规，确认：

• WordPress地址（URL）：http://localhost/mysite_local
• 站点地址（URL）：http://localhost/mysite_local
  保存设置后刷新页面测试。

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