XAMPP 自带 Perl 但需手动启用 CGI：取消 httpd.conf 中 LoadModule cgi_module 和 ScriptAlias 相关注释，配置 授权 ExecCGI，确保脚本有执行权限、正确 shebang 及 \r\n\r\n 结尾的 header，错误时查 error_log 日志。
确认 XAMPP 自带 Perl 并已启用 CGI 模块
XAMPP 从较早版本起就默认集成 Perl（Windows 版通常含 ActivePerl，Linux 版如 xampp-linux-x64-7.4.5-0-installer.run 也自带），但 Apache 默认不启用 CGI 支持。关键不是“装没装 Perl”，而是 Apache 是否加载了 mod_cgi 或 mod_cgid，以及是否允许执行 /cgi-bin/ 下的脚本。
检查方法：打开 /opt/lampp/etc/httpd.conf（Linux）或 C:\xampp\apache\conf\httpd.conf（Windows），搜索以下两行：
LoadModule cgi_module modules/mod_cgi.so Include etc/extra/httpd-cgi.conf
如果被注释（行首有 #），需取消注释；若不存在，说明你的 XAMPP 版本可能用的是 mod_cgid（多进程 CGI），此时应启用 LoadModule cgid_module modules/mod_cgid.so 并确保 ScriptAlias 配置指向正确路径。
配置 ScriptAlias 和目录权限
Apache 必须明确知道哪段 URL 映射到哪个本地目录，并赋予该目录执行 CGI 的权限。常见错误是只改了 ScriptAlias 却漏掉对应的
在 httpd.conf 或 etc/extra/httpd-cgi.conf 中确保包含：
ScriptAlias /cgi-bin/ "/opt/lampp/cgi-bin/"
<directory>
AllowOverride None
Options +ExecCGI
Require all granted
</directory>
-
Options +ExecCGI是必须的，仅靠ScriptAlias不足以启用执行权 - Windows 用户注意路径分隔符和反斜杠转义，例如
"C:/xampp/cgi-bin/" - XAMPP 8.2+ 默认使用
Require all granted，旧版（如 7.4）可能仍用Order allow,deny+Allow from all，需按版本调整
脚本文件权限与 Shebang 行必须正确
Linux/macOS 下，.cgi 或 .pl 文件必须有可执行权限，且第一行 #!（shebang）必须指向真实存在的 Perl 解释器路径。Windows 下虽不依赖 chmod，但若通过 WSL 或 Linux 版 XAMPP 运行，仍需处理。
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
典型问题：
-
End of script output before headers：多半因脚本无执行权限（chmod a+x /opt/lampp/cgi-bin/test.cgi）或输出了非法字符（如 UTF-8 BOM、多余空行） -
(13) Permission denied: exec of 'xxx' failed：shebang 路径错误，比如写成#!/usr/bin/perl，但实际 Perl 在/opt/lampp/perl/bin/perl；可用which perl或/opt/lampp/perl/bin/perl -v确认 - 脚本必须以
\r\n\r\n结束 HTTP header（两个 CRLF），不能只用\n\n，否则 Apache 认为 header 不完整
调试 500 错误时优先查 error_log 和 shebang 输出
Apache 500 错误本身不暴露原因，真正线索全在日志里。XAMPP 的错误日志路径固定：
- Linux：
/opt/lampp/logs/error_log - Windows：
C:\xampp\apache\logs\error.log
运行 tail -f /opt/lampp/logs/error_log 后访问 http://localhost/cgi-bin/test.cgi，实时看报错。高频线索包括：
-
Can't locate CGI.pm in @INC：说明脚本用了use CGI但 XAMPP 自带 Perl 未预装该模块（较新 XAMPP 可能精简了），改用原始 CGI 头输出，或手动安装：/opt/lampp/perl/bin/perl -MCPAN -e 'install CGI' -
malformed header：脚本 print 语句漏了\r\n，或 header 后多输出了空格/空行 -
Permission denied层层递进：先查文件权限，再查 shebang 路径，最后查父目录（如/opt/lampp/cgi-bin/）是否对 Apache 用户（通常是daemon或nobody）可读
最易被忽略的是：Windows 用户在记事本里编辑 CGI 脚本后保存为 UTF-8 with BOM，导致第一行 shebang 实际是不可见的 BOM 字节，Perl 直接报错无法解析。务必用 VS Code、Notepad++ 等工具另存为 “UTF-8 无 BOM” 编码。
