
本文详解 xampp 环境下 wordpress “404 not found” 错误的根源与解决方案,重点纠正 zip 文件未解压直传、目录结构错误等常见新手误区,并提供完整部署验证步骤。
本文详解 xampp 环境下 wordpress “404 not found” 错误的根源与解决方案,重点纠正 zip 文件未解压直传、目录结构错误等常见新手误区,并提供完整部署验证步骤。
在使用 XAMPP 搭建本地 WordPress 开发环境时,许多初学者会遇到如下典型错误页面:
Not Found The requested URL was not found on this server. Apache/2.4.52 (Win64) OpenSSL/1.1.1m PHP/8.1.4 Server at localhost Port 80
当你访问 http://localhost/wordpress 或 http://localhost:80/wordpress 却看到该提示,核心原因几乎总是:WordPress 安装包未正确解压并部署至 htdocs 目录下——而非 Apache、PHP 或端口配置问题。
✅ 正确部署步骤(以 Windows + XAMPP 为例)
确认 XAMPP 已正常启动 Apache(且 MySQL 可选)
打开 XAMPP Control Panel → 启动 Apache(绿色 Running 状态)。确保无端口冲突(如 Skype 占用 80 端口),可通过 http://localhost 访问 XAMPP 欢迎页验证基础服务。-
下载并解压 WordPress 完整源码包
- 前往 https://www.php.cn/link/18cd1cd589e0558e181846f152da973f 下载最新 .zip 包(例如 wordpress-6.5.3-zh_CN.zip);
- 关键操作:右键该 ZIP 文件 → 选择「全部解压缩」→ 指定目标文件夹(如桌面临时目录);
- 解压后你会得到一个名为 wordpress/ 的文件夹,其内部包含 wp-admin/、wp-includes/、index.php、wp-config-sample.php 等数十个文件与子目录。
-
将 WordPress 内容 复制到 htdocs,而非 ZIP 文件本身
❌ 错误做法:直接把 wordpress.zip 放入 C:\xampp\htdocs\;
❌ 错误做法:把整个 wordpress/ 文件夹(含外层目录名)放入 htdocs,导致路径变为 htdocs\wordpress\wordpress\...;
✅ 正确做法:# 进入解压后的 wordpress/ 目录 # 全选其中所有文件和子目录(Ctrl+A) # 复制(Ctrl+C) # 粘贴到 XAMPP htdocs 根目录下 # 最终结构应为: C:\xampp\htdocs\index.php ← XAMPP 自带 C:\xampp\htdocs\wordpress\ ← 你手动创建的子目录(可选) C:\xampp\htdocs\wp-admin\ ← WordPress 核心文件(若直接放根目录) C:\xampp\htdocs\wp-config.php ← 配置文件(需重命名并编辑)
? 提示:推荐将 WordPress 放在子目录(如 htdocs\wordpress\)便于多项目管理。此时访问地址为 http://localhost/wordpress/。
-
初始化 WordPress 安装
浏览器访问 http://localhost/wordpress/(注意末尾 /)→ 将自动跳转至安装向导 wp-admin/install.php;
若提示“无法创建 wp-config.php”,请手动执行:- 将 htdocs\wordpress\wp-config-sample.php 重命名为 wp-config.php;
- 编辑该文件,修改数据库连接参数(默认 DB_NAME='wordpress', DB_USER='root', DB_PASSWORD='');
- 保存后刷新页面继续安装。
⚠️ 关于 Tomcat 报错的说明(非 WordPress 必需)
你提到的 Tomcat Not Found! 是 XAMPP 中 Java 组件的独立问题,与 WordPress 运行完全无关。WordPress 基于 PHP+MySQL,无需 Tomcat(Tomcat 用于 Java Web 应用,如 JSP)。XAMPP 默认不启用 Tomcat,也不影响 Apache/PHP 功能。可忽略此提示,专注 Apache 和 MySQL 服务即可。
✅ 验证与排错清单
| 检查项 | 正确状态 | 说明 |
|---|---|---|
| http://localhost 能打开 XAMPP 首页 | ✅ | 表明 Apache 正常运行 |
| htdocs\wordpress\ 下存在 wp-admin/、wp-includes/、index.php | ✅ | 确认已解压且路径扁平化 |
| URL 中无多余 .zip 或重复目录名(如 localhost/wordpress/wordpress/) | ✅ | 避免路径层级错误 |
| 浏览器地址栏显示 http://localhost/wordpress/(结尾有 /) | ✅ | Apache 需目录索引触发 index.php |
? 终极提醒:WordPress 不是一个“.exe”或单文件程序,而是一套完整的 PHP Web 应用目录结构。解压是不可跳过的必要步骤。 JDK/JRE、Tomcat 的安装对 PHP 环境毫无帮助,切勿混淆技术栈。
完成上述操作后,刷新浏览器,你将看到熟悉的 WordPress 安装界面——本地开发之旅,正式启程。










