如何解决本地部署PHP项目HAWKI时的404对象未找到错误？

排查文件结构 #

• 确认克隆的项目文件是否直接放在htdocs/hawki目录下：打开XAMPP的htdocs/hawki文件夹，检查是否能直接看到login.php、.htaccess等核心文件，而非嵌套在HAWKI或HAWKI-master这类子文件夹中。如果存在嵌套，将内层所有文件移动到htdocs/hawki根目录下。

开启Apache重写模块 #

• 打开XAMPP控制面板，点击Apache的Config按钮，选择Apache (httpd.conf)。
• 在配置文件中找到#LoadModule rewrite_module modules/mod_rewrite.so行，去掉开头的#注释符，保存文件。
• 重启XAMPP的Apache服务，确保重写模块生效。

检查.htaccess配置 #

• 确认项目根目录下存在.htaccess隐藏文件，若没有则手动创建，基础重写规则可参考：

RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^login$ login.php [L]
RewriteRule ^(.*)$ index.php [L]

• 确保Apache允许.htaccess生效：在httpd.conf中找到对应htdocs的<Directory>配置块（如<Directory "C:/xampp/htdocs">），将AllowOverride None修改为AllowOverride All，保存后重启Apache。

直接访问PHP文件验证 #

• 先尝试访问http://localhost/hawki/login.php，若能正常打开，说明核心文件无问题，故障出在URL重写配置，回到前面步骤检查重写模块和.htaccess。
• 若login.php也返回404，再次确认文件路径是否正确，以及XAMPP的Apache服务是否正常运行。

文件权限检查 #

• Windows系统：右键htdocs/hawki文件夹，选择“属性”，取消“只读”勾选；
• Linux/macOS系统：打开终端执行sudo chmod -R 755 /你的XAMPP路径/htdocs/hawki，调整实际路径后运行。

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