Mac系统XAMPP配置虚拟主机出现Error 500问题求解

先梳理下你目前的操作：
你在Mac上用XAMPP配置虚拟主机，Apache配置里添加了这段代码：

<VirtualHost 127.0.0.1:80>
    ServerName mvcproject.local
    DocumentRoot "/Applications/XAMPP/xamppfiles/htdocs/mvcproject/public"
</VirtualHost>
<Directory "/Applications/XAMPP/xamppfiles/htdocs/mvcproject/public">
    Options Indexes FollowSymLinks Includes ExecCGI
    AllowOverride All
    Require all granted
</Directory>

同时修改了hosts文件：

127.0.0.1 localhost
255.255.255.255 broadcasthost
::1 localhost
127.0.0.1 Masouds-MacBook-Pro.local # added by Apache Friends XAMPP
127.0.0.1 mvcproject.local

但访问mvcproject.local时遇到了500内部服务器错误，下面是几个针对性的排查和解决步骤：

1. 先修复文件权限（Mac上最常见的坑） #

XAMPP的Apache进程是以_www用户身份运行的，如果你项目目录的权限不对，Apache就没法读取或执行文件，直接触发500错误。打开终端运行这两个命令：

sudo chmod -R 755 /Applications/XAMPP/xamppfiles/htdocs/mvcproject
sudo chown -R _www:_www /Applications/XAMPP/xamppfiles/htdocs/mvcproject

第一个命令设置目录和文件的读写执行权限，第二个命令把目录所有权转到Apache的用户组。

2. 查看Apache错误日志找具体原因 #

500错误只是笼统提示，日志里会有详细的错误信息。打开XAMPP的日志目录：/Applications/XAMPP/xamppfiles/logs/，用文本编辑器打开error_log文件，里面会记录比如：

• .htaccess语法错误
• PHP脚本的致命错误
• 目录路径不存在的问题
  这些细节能直接帮你定位问题。

3. 排查.htaccess文件的问题 #

你的VirtualHost配置里开了AllowOverride All，意味着public目录下的.htaccess会生效，如果这个文件里的Rewrite规则或者其他配置写错了，就会触发500错误。
你可以先把.htaccess重命名为.htaccess.bak，然后重启Apache再访问网站，如果能正常打开，那就是.htaccess的问题，逐行检查里面的规则，比如RewriteBase是否正确，有没有语法错误。

4. 验证Apache配置的语法正确性 #

有时候VirtualHost的配置可能有语法错误（比如标签没闭合、路径写错），用终端运行这个命令检查：

/Applications/XAMPP/xamppfiles/bin/apachectl configtest

如果配置有问题，会直接提示错误位置；显示Syntax OK就是没问题，修正后重启Apache即可。

5. 检查PHP错误日志 #

如果是项目里的PHP代码有致命错误（比如语法错误、调用不存在的函数），也会导致500错误。打开XAMPP的php_error_log日志（同样在/Applications/XAMPP/xamppfiles/logs/目录下），里面会记录PHP的错误详情，根据提示修正代码即可。

最后，每修改完配置或权限，记得重启XAMPP的Apache服务，确保生效。

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