Apache2本地环境中CGI脚本调用后显示为纯文本的问题求助

我之前在搭建带登录/注册功能的Apache Web服务器时，也碰到过一模一样的CGI脚本直接显示纯文本的坑！折腾了好几个小时才把所有问题捋清楚，给你列几个按优先级排序的排查和修复步骤，按顺序试下来应该能解决：

1. 确认CGI模块真的被启用 #

别只盯着/etc/apache2/httpd.conf里的注释，不同发行版的Apache配置方式不一样：

• Debian/Ubuntu系：直接用命令启用更靠谱，避免手动改文件出错：

  sudo a2enmod cgi
  sudo systemctl restart apache2
  

• RHEL/CentOS系：确保httpd.conf里的LoadModule cgi_module modules/mod_cgi.so没有被注释，然后重启服务：

  sudo systemctl restart httpd
  

2. 检查CGI脚本的权限与所有者 #

Apache的运行用户（通常是www-data或apache）必须拥有脚本的读取和执行权限，否则没法解析：

# 给脚本加执行权限
sudo chmod +x /path/to/your/cgi/script.pl
# 把所有者改成Apache运行用户
sudo chown www-data:www-data /path/to/your/cgi/script.pl

（把.pl换成你脚本的后缀，比如.sh、.py）

3. 确保CGI目录的配置正确 #

找到你的CGI目录对应的<Directory>配置块（可能在httpd.conf、sites-available/000-default.conf或者虚拟主机配置文件里），必须包含以下关键配置：

<Directory "/var/www/cgi-bin">
    Options +ExecCGI  # 注意是加号，确保开启执行CGI的权限
    AddHandler cgi-script .cgi .pl .sh .py  # 列出你要解析的脚本后缀
    AllowOverride None
    Require all granted
</Directory>

如果是虚拟主机环境，一定要把这段配置放到<VirtualHost>块内部，否则全局配置可能不生效。改完后记得重启Apache。

4. 检查脚本的Shebang首行 #

这是最容易被忽略的点！脚本第一行必须指定正确的解释器路径，Apache靠这个来调用对应的解析器：

• Perl脚本示例：

  #!/usr/bin/perl
  

• Python脚本示例：

  #!/usr/bin/env python3
  

可以用which perl或which python3命令确认解释器的正确路径，确保首行路径和实际一致。

5. 用正确的URL访问脚本 #

别直接在浏览器里打开本地文件（比如file:///var/www/cgi-bin/script.pl），必须通过Apache的HTTP URL访问，比如http://your-domain/cgi-bin/script.pl，这样Apache才会触发CGI解析流程。

6. 查看Apache错误日志找根源 #

如果上面的步骤都试过还是不行，直接看错误日志，里面会有明确的报错信息（比如权限不足、Shebang错误、模块未加载等）：

• Debian/Ubuntu系日志路径：

  tail -f /var/log/apache2/error.log
  

• RHEL/CentOS系日志路径：

  tail -f /var/log/httpd/error_log
  

刷新浏览器访问脚本的同时，实时看日志输出，就能精准定位问题了。

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