Mac系统Apache服务器中Perl脚本无法解析仅显示纯文本

问题情况 #

Mac系统下Apache Web服务器其余功能正常，但Perl脚本无法被解析访问时直接以纯文本形式展示；已尝试修改httpd.conf中CGI相关配置，但现有在线方案均未生效。

用户已修改的httpd.conf配置片段 #

1. CGI模块加载配置

<IfModule !mpm_prefork_module>
    LoadModule cgid_module libexec/apache2/mod_cgid.so
</IfModule>
<IfModule mpm_prefork_module>
    #LoadModule cgi_module libexec/apache2/mod_cgi.so
</IfModule>

2. 根目录权限配置

<Directory />
    AllowOverride None
    Options FollowSymLinks +ExecCGI
</Directory>

3. 文档根目录与对应目录配置

DocumentRoot "/usr/local/var/www/cgi-bin/"
<Directory "/usr/local/var/www/cgi-bin/">
    Options ExecCGI +FollowSymLinks +Multiviews
    MultiviewsMatch Any

    AllowOverride All

    Require all granted
</Directory>

4. ScriptAlias配置

ScriptAlias /cgi-bin/ "/usr/local/var/www/cgi-bin/"

5. 重复的cgi-bin目录配置

<Directory "/usr/local/var/www/cgi-bin/">
    AllowOverride None
    Options ExecCGI
    Require all granted
</Directory>

6. MIME模块尝试修改项

AddHandler cgi-script .cgi
Options ExecGI

排查与解决步骤 #

1. 修正MIME配置的拼写错误
   你在MIME模块里写的Options ExecGI是拼写错误，正确应为Options ExecCGI，同时要添加.pl后缀让Apache识别Perl脚本：

   AddHandler cgi-script .cgi .pl
   Options ExecCGI
   

2. 清理重复的目录配置
   两段针对/usr/local/var/www/cgi-bin/的Directory配置存在规则冲突，会导致Apache优先级混乱，保留一段统一配置即可，推荐使用：

   <Directory "/usr/local/var/www/cgi-bin/">
       Options ExecCGI +FollowSymLinks +Multiviews
       MultiviewsMatch Any
       AllowOverride All
       Require all granted
   </Directory>
   

3. 确保Perl脚本的权限与首行声明

   • 给Perl脚本添加可执行权限：终端执行 chmod +x /usr/local/var/www/cgi-bin/你的脚本名.pl
   • 脚本首行必须声明Perl解释器路径，Mac默认路径可通过which perl命令确认，一般为#!/usr/bin/perl或#!/usr/local/bin/perl，写在脚本第一行。

4. 确认CGI模块正确加载
   终端执行httpd -V | grep MPM查看当前Apache使用的MPM模块：

   • 若输出MPM_NAME: prefork，取消注释LoadModule cgi_module libexec/apache2/mod_cgi.so
   • 若输出event或worker，保留cgid_module的加载即可

5. 重启Apache服务
   修改配置后必须重启生效：终端执行sudo apachectl restart，再测试脚本访问。

6. 查看错误日志定位问题
   若仍未解决，查看Apache错误日志找具体原因：

   tail -f /usr/local/var/log/apache2/error_log
   

   （部分安装环境下日志路径可能为/var/log/apache2/error_log）

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