Apache运行Perl脚本报500 malformed header错误排查

报错malformed header from script. Bad header=<!DOCTYPE html>的核心原因是Perl脚本作为CGI运行时，没有按照CGI规范输出合法的HTTP响应头，Apache直接把脚本输出的正文内容当成响应头解析，触发格式错误。
终端执行perl hello.pl能正常运行不代表符合Web服务的CGI运行要求：CLI环境下不需要输出HTTP协议相关的头信息，只要输出内容即可，和Apache调用脚本的逻辑完全不同。

1. 补全CGI脚本强制要求的响应头，且头与正文之间必须保留空行
   你当前的测试脚本只输出了正文内容，缺少最核心的Content-Type声明，这是90%同类报错的直接诱因。将脚本修改为如下内容即可：

#!/usr/bin/perl

print "Content-type: text/html\n\n";
print "Hello, World!\n";
```
> 注意：头和正文之间的空行是CGI规范强制要求，少一个换行都会触发头格式错误。

2. 核对基础配置项（即使你确认已经配置过，也建议逐一校验）
   • 校验shebang路径：在终端执行which perl，确认输出的Perl解释器路径和脚本第一行的#!/usr/bin/perl完全一致。如果你的Perl安装在其他路径（比如/usr/local/bin/perl），直接修改shebang行即可——终端执行脚本时是手动调用perl解释器，不会走shebang的路径，所以CLI运行正常不代表shebang配置正确。
   • 校验Apache CGI配置：
     • 存放Perl脚本的目录必须开启ExecCGI权限，对应目录配置段需要包含Options +ExecCGI
     • 必须配置后缀与CGI处理器的映射：AddHandler cgi-script .pl
     • 修改完Apache配置后必须执行重载操作才会生效：Debian/Ubuntu系统执行systemctl reload apache2，CentOS/RHEL系统执行systemctl reload httpd
   • 校验权限：不要只给脚本文件加可执行权限，脚本所在的所有上级目录都需要给Apache运行用户开放遍历（可执行）权限，禁止将CGI脚本放在/root这类root用户私有目录下。
   • 校验文件格式：如果脚本是在Windows环境下编写后上传到服务器，需要执行dos2unix hello.pl将Windows格式的CRLF换行转为Unix格式的LF换行，避免shebang行携带特殊字符导致解释器调用失败。

如果调整后依然报错，直接查看Apache的错误日志获取精准报错信息，日志默认路径：

• Debian/Ubuntu: /var/log/apache2/error.log
• CentOS/RHEL: /var/log/httpd/error_log
  前端返回的500状态码是通用错误提示，错误日志里会明确记录是脚本权限、解释器路径、头格式哪一环出了问题。

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