使用Apache2服务器访问自定义页面时出现HTTP 500错误求助

Web开发新手，正在完成课程项目，已安装PHP8.1、Apache2（版本2.4）。访问Apache默认页面正常，但替换或添加自定义页面（包括将index.php改为index.html、注释大部分代码后）时，通过localhost访问均出现HTTP 500错误。该页面在VSCode的Live Server插件中可正常运行，怀疑是安装损坏或权限问题，寻求解决方法。

附代码：

<?php 
  //  include 'databaseAPI.php';
?>


<!DOCTYPE html>
<head>
    <h1>My E-Shop</h1>
    <hr>
</head>

<body>
 <!--   <form action="welcome.php" method="post">
        <label for="fname">Username:</label>
        <input type="text" id="username">
        <br><br>
        <label for="lname">Password:</label>
        <input type="password" id="password">
        <br><br>
        <input type="submit" value="Submit">
    </form> -->
</body>

排查与解决步骤 #

• 优先查看Apache错误日志：HTTP 500是服务器内部错误，日志会给出具体原因，这是最快定位问题的方式
  • Linux系统：日志路径通常为/var/log/apache2/error.log，用命令tail -f /var/log/apache2/error.log实时查看最新错误信息
  • Windows系统：日志在Apache安装目录的logs/error.log文件中
• 检查文件与目录权限
  • Linux：确保网站根目录（默认/var/www/html）及内部文件归Apache运行用户（通常为www-data）所有，执行命令：

    sudo chown -R www-data:www-data /var/www/html
    sudo chmod -R 755 /var/www/html
    

  • Windows：右键网站文件夹→「属性」→「安全」，给Apache服务对应的用户添加读取和执行权限
• 验证PHP与Apache的兼容性
  • 在网站根目录创建phpinfo.php，内容为：

    <?php phpinfo(); ?>
    

  • 访问localhost/phpinfo.php，若能正常显示PHP信息，说明PHP模块加载正常；若无法访问，检查Apache配置文件中是否存在LoadModule php8_module相关配置且未被注释
• 检查文件格式与语法
  • 确保代码文件以UTF-8无BOM格式保存，避免隐藏特殊字符导致解析错误
  • 即使代码被注释，也要确认PHP标签<?php ?>无语法错误
• 验证Apache配置合法性
  • Linux执行命令sudo apache2ctl configtest，Windows在Apache的bin目录运行httpd -t，若配置存在语法错误会直接提示，修复后重启Apache服务

内容的提问来源于stack exchange，提问作者Νικόλας Καστρινάκης