XAMPP本地环境下WordPress postname固定链接失效问题
XAMPP环境下WordPress postname固定链接异常排查方案
问题核心成因
XAMPP默认安装后,切换WordPress为postname形式的固定链接,出现的创建文章JSON报错、Elementor加载失败、操作频繁404的连锁问题,本质是Apache环境未配置好伪静态重写规则的运行条件。
因为postname模式下的所有链接不是指向实际存在的物理文件,需要依赖Apache的重写模块把请求映射回WordPress的核心入口index.php,XAMPP默认配置通常存在两个阻断点:一是重写模块未启用,二是站点目录禁止读取.htaccess规则文件,最终所有依赖重写路由的请求全部返回404,触发上层的各类功能异常。
分步修复操作
1. 启用Apache重写模块
- 打开XAMPP控制面板,找到Apache服务对应的
Config按钮,选择打开httpd.conf配置文件。 - 在文件中定位到
LoadModule rewrite_module modules/mod_rewrite.so这一行,去掉行首的注释符号#,让模块处于生效状态。 - 保存配置文件,重启Apache服务。
2. 放开.htaccess文件的读取权限
- 同样在
httpd.conf配置文件中,定位到默认站点根目录(一般路径为C:/xampp/htdocs)对应的权限配置段:<Directory "C:/xampp/htdocs"> Options Indexes FollowSymLinks Includes ExecCGI AllowOverride None Require all granted </Directory> - 将配置中的
AllowOverride None修改为AllowOverride All,允许Apache读取站点目录下.htaccess中存储的重写规则。 - 保存配置文件,重启Apache使权限设置生效。
3. 触发WordPress重写规则重写
- 进入WordPress后台的
设置-固定链接页面,无需修改任何选项,直接点击页面下方的保存更改按钮,让WordPress自动在站点根目录生成适配的.htaccess重写规则。 - 可手动检查根目录
.htaccess文件,确认存在如下WordPress默认规则段即说明写入成功:# 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
4. 异常验证与兜底处理
- 如果WordPress无法自动生成
.htaccess文件,可手动在站点根目录新建该文件,粘贴上面的默认规则段即可。 - 配置完成后依次验证之前的三个异常点:
- 新建文章提交是否还弹出JSON接口报错
- Elementor构建器是否能正常加载编辑界面
- 页面编辑、前端访问操作是否还触发404错误
- 若仍有JSON类接口报错,可临时排查本地安装的安全插件是否拦截了
localhost来源的REST请求,本地开发场景下将本地地址加入白名单即可解决。
内容的提问来源于stack exchange,提问作者Amir
相关产品推荐
相关产品推荐

