錯誤現象

Internal Server Error
The server encountered an internal error or misconfiguration...
Additionally, a 404 Not Found error was encountered while trying to use an ErrorDocument...

核心排查步驟

1. 檢查 Shebang 行：首行必須指向正確 Perl 路徑。

   #!/usr/bin/perl
   # 或
   #!/usr/local/bin/perl

   用 `which perl` 或 `perl -v` 確認路徑，虛擬主機常不同於本地。
2. 文件權限 755：`chmod 755 script.pl`，目錄至少 755。
3. 行尾格式：上傳前轉 **Unix (LF)**，Windows (CRLF) 會導致 Shebang 解析失敗。編輯器設置「保存為 Unix 格式」。
4. CGI 目錄配置：確認 `public_html/cgi-bin/` 或 `.htaccess` 有 `Options +ExecCGI`、`AddHandler cgi-script .pl`。
5. 錯誤日志：控制面板查看 `error_log`，或腳本開頭添加：

   #!/usr/bin/perl
   use CGI::Carp qw(fatalsToBrowser); # 將 Perl 錯誤直接輸出到瀏覽器
   print "Content-type: text/html\n\n";

6. 模塊依賴：`use Some::Module;` 若主機未安裝會 500。用 `cpanm` 本地安裝到 `lib/`，腳本 `use lib 'lib';`。
7. 編碼聲明：輸出中文需 `binmode STDOUT, ':encoding(UTF-8)';`。

快速測試腳本

#!/usr/bin/perl
use strict; use warnings;
use CGI::Carp qw(fatalsToBrowser);
print "Content-type: text/html; charset=UTF-8\n\n";
print "
Perl CGI Works!
";
print "
Perl: $^V
";
print "
ENV: " . join(", ", sort keys %ENV) . "
";
print "";

聯系主機商時提供的信息

• 完整錯誤日志片段（含時間戳）。
• 腳本路徑、權限、Shebang 行。
• 本地測試通過的證據（截圖/日志）。

常見主機商限制

總結

虛擬主機 Perl 500 錯誤 90% 是 **Shebang 路徑錯、行尾 CRLF、權限不足、缺模塊**。依次排查，配合 `CGI::Carp qw(fatalsToBrowser)` 直觀定位。若主機商限制過多，建議遷移至 VPS/雲服務器獲得完整控制權。