Apache2服务器运行C++ CGI异常：点击按钮直接下载cgi文件

排查步骤： #

• 检查CGI脚本执行权限
  确保song_stack.cgi具备可执行权限，执行命令：

  chmod +x /opt/homebrew/var/www/cgi-bin/song_stack.cgi
  

  同时通过ls -l /opt/homebrew/var/www/cgi-bin/song_stack.cgi确认Apache运行用户（通常为_www）对该文件拥有读、执行权限。

• 验证httpd.conf的CGI配置细节

  • 确认mod_cgi已加载：检查配置文件中是否存在LoadModule cgi_module lib/httpd/modules/mod_cgi.so，且未被注释（Homebrew环境下路径需匹配实际安装位置）。
  • 确认ScriptAlias配置正确：确保存在ScriptAlias /cgi-bin/ "/opt/homebrew/var/www/cgi-bin/"，路径与实际CGI目录完全一致。
  • 确认CGI目录的权限规则：

    <Directory "/opt/homebrew/var/www/cgi-bin">
        AllowOverride None
        Options +ExecCGI
        Require all granted
    </Directory>
    

  • 确保配置了CGI文件类型关联：添加或确认存在

    AddHandler cgi-script .cgi .pl
    

• 检查CGI脚本的输出格式
  C++编写的CGI脚本必须先输出标准HTTP头，否则Apache无法识别输出类型，会触发下载行为。示例开头代码：

  cout << "Content-type: text/html\r\n\r\n";
  

• 确认表单访问路径正确性
  检查index.html中表单的action属性是否指向正确的CGI路径，应为action="/cgi-bin/song_stack.cgi"，而非本地文件路径。

• 查看Apache错误日志定位问题
  查看Homebrew Apache的错误日志（通常在/opt/homebrew/var/log/httpd/error_log），执行tail -f /opt/homebrew/var/log/httpd/error_log后提交表单，根据日志中的权限错误、配置错误或脚本执行错误信息进一步排查。

内容的提问来源于stack exchange，提问作者DEADPØØL GAMING