小粋空間  -  a cheap joke and a play on words site

「Premature end of script headers」の対処方法

PerlのCGIで「Premature end of script headers」というエラーが発生する場合の対処方法を紹介します。

１．はじめに

Perlで簡単なCGIを書いて、さくらインターネットのサーバにアップロードして実行したところ、「Internal Server Error」が発生しました。

Apacheのエラーログを見ると、

Premature end of script headers: /home/xxxxx/www/test.cgi

というエラーが発生していました。

かなり初歩的なミスで今までも同じ失敗をしてきたと思うので、備忘録で残しておきます。

１．「Premature end of script headers」とは

「Premature end of script headers」は分かりにくいエラーですが、「スクリプトヘッダーの早すぎる終わり」、つまり「HTTPヘッダーが不完全である」というエラーを指すようです。

もう少し分かりやすく言うと、「CGIプログラムが適切なHTTPヘッダを出力していない」ということになります。

２．エラーになる原因

原因はファイルの改行コードです。

Linuxでファイルの改行コードがCR+LFのままCGIを実行すると、「Premature end of script headers」というエラーになります。

エラーになる理由は、まずLinuxのApacheでは改行コードをLFでしか認識してくれないようで、Perlのshebang行、

#!/usr/bin/perl

の行末に改行コード「CR+LF」があると、LFだけを改行コードと認識するため、余ったCRがPerlのパスにくっついて、

#!/usr/bin/perl<CR>

と解釈されてしまうようです。

そのようなPerlのパスが存在しないことでCGIが正常に動作しなくなり、後方のヘッダ出力も正常に行われず、結果的に「Premature end of script headers」というエラーになるようです。

なお、ネットを検索すると、

#!/usr/bin/perl --

とすると解消するという記事が多くありますが、これは「--」を付与することで「#!/usr/bin/perl」の直後にCRが付与されなくなってパスが正しく認識されるためで、本質的な解決策ではありません。

よって、ファイルの改行コードをLFに変換すれば本問題は解消されると思います。

ただしファイルやディレクトリのパーミッションなどでひっかかる場合もあるので、改行コードが原因でないケースもあります。

３．「Premature end of script headers」を故意に出力する

２項の裏返しで、「Premature end of script headers」を故意に出力するには、次の1行だけの内容のファイル（改行コードはLF）を実行すればいいことになります。

#!/usr/bin/perl

またはshebang行のパスを誤った内容にします。エラーの原因と同じように末尾に適当な文字列をつけてみてもいいでしょう。

#!/usr/bin/perlhoge

いずれにしてもHTTPヘッダが出力されなければ「Premature end of script headers」となります。

４．その他

Apacheのドキュメントにも参考情報が掲載されています。

Apache Tutorial: CGI による動的コンテンツ