
本文详解 xampp 环境下 wordpress 无法访问(404 错误)的常见原因及完整解决流程,重点纠正 zip 文件未解压直传、目录结构错误等新手高频误区,并提供可验证的操作步骤与注意事项。
本文详解 xampp 环境下 wordpress 无法访问(404 错误)的常见原因及完整解决流程,重点纠正 zip 文件未解压直传、目录结构错误等新手高频误区,并提供可验证的操作步骤与注意事项。
在本地搭建 WordPress 开发环境时,出现类似 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 的 404 报错,绝大多数情况下并非 Apache 或 PHP 配置故障,而是 WordPress 文件未正确部署到 Web 根目录。尤其对初学者而言,容易将下载的 wordpress-x.x.x-zh_CN.zip 直接复制进 htdocs,却未解压——这会导致 localhost/wordpress 实际指向一个压缩包而非可运行的网站目录,Apache 自然无法识别并返回“Not Found”。
✅ 正确部署步骤(以 Windows + XAMPP 为例)
确认 XAMPP 已正常启动 Apache(且端口 80 未被占用)
打开 XAMPP Control Panel → 启动 Apache 模块。若启动失败,检查是否被 Skype、IIS 或其他服务占用 80 端口(可在 Config → Service and Port Settings 中临时改用 8080 测试)。-
下载并解压 WordPress 官方安装包
- 访问 https://www.php.cn/link/18cd1cd589e0558e181846f152da973f → 下载中文版 ZIP 包(如 wordpress-6.5.3-zh_CN.zip)。
-
关键操作:右键 ZIP 文件 → “全部解压缩…” → 选择目标文件夹为 XAMPP\htdoc\
✅ 正确路径示例:XAMPP\htdocs\wordpress\(该目录下应包含 wp-admin/、wp-includes/、index.php、wp-config-sample.php 等标准文件和子目录)
❌ 错误做法:直接把 wordpress.zip 复制到 htdocs,或解压后得到 XAMPP\htdocs\wordpress\wordpress\(多了一层嵌套)。
-
验证基础访问
浏览器访问 http://localhost/wordpress/ —— 若仍报 404,请检查:- 地址末尾是否遗漏 /(localhost/wordpress ≠ localhost/wordpress/,部分 Apache 配置需显式斜杠);
- 是否误将文件放入 htdocs\wordpress.zip 或 htdocs\wordpress\wordpress\;
- 使用资源管理器确认 XAMPP\htdocs\wordpress\index.php 确实存在。
启动 WordPress 安装向导
访问 http://localhost/wordpress/wp-admin/install.php,即可进入图形化安装流程(需提前创建 MySQL 数据库,XAMPP 默认可通过 http://localhost/phpmyadmin/ 创建)。
⚠️ 关于 Tomcat 报错的说明(非 WordPress 必需)
你提到的 Tomcat Not Found! Disabling Tomcat buttons 是 XAMPP 的提示信息,与 WordPress 运行完全无关。WordPress 基于 PHP+MySQL,依赖 Apache/Nginx 和 PHP 解释器,无需 Tomcat(Java 应用服务器)。JDK/JRE 的安装属于无效操作,可卸载以避免环境干扰。
? 快速自查清单
- [ ] XAMPP\htdocs\wordpress\ 目录下是否存在 index.php?
- [ ] XAMPP\htdocs\wordpress\ 是否为解压后的完整 WordPress 目录(非 ZIP 文件本身)?
- [ ] Apache 是否已启动?状态栏显示绿色 Running?
- [ ] 浏览器地址栏输入的是 http://localhost/wordpress/(含协议 http:// 和结尾 /)?
? 总结
本地 WordPress 部署失败的根源,90% 以上源于“ZIP 未解压”或“目录层级错误”。牢记:WordPress 是一个由数百个文件组成的完整应用目录,不是单个可执行文件。只要确保 htdocs 下存在结构正确的 wordpress/ 子目录,并启动 Apache,即可顺利进入安装界面。后续数据库配置、管理员账号设置等均在浏览器中图形化完成,无需命令行或 Java 环境支持。










