Category
INDEX
Apacheでサーバエラーページの変更
#Linux
投稿日:2023-09-25
更新日:2026-08-08
関連ページ
参考URL
ApacheとTomcatを連携させてサイトを運営していると、サイトに更新をかける際に必ずTomcatをRestartさせる瞬間があります。
この際Tomcatが一時的に停止状態になるので、このわずかな時間内にサイトにアクセスした人はApacheから下のような503エラー文を見ることになります。
こういうのを見ると一般の人はもう運営していないサイトと勘違いする可能性もあるので、日本語の「メンテナンス中です」みたいなページに置き換えたい。
しかしErrorDocumentをconfに書き込んでも全く反映されませんでした。
これの解決方法が分かったのでそのメモ。
Apacheでサイトを運営しているなら、confファイルに
ただリバースプロキシを使ってApacheとTomcatを連携していると、リバースプロキシの設定が優先処理されるらしく、ErrorDocumentが機能しません。
仮に上のVirtualHost設定で、Tomcatを停止してサイトに繋ぐと下のようなエラー文が追加されます。
Proxyでは、特定のファイルやディレクトリにアクセスしてきた際に、その下のリバースプロキシを実行しない方法があります。
上のコードでは、
さらにサーバエラーが発生した際に、Proxy設定を上書きして特定のページを参照させる方法があります。
まとめると次の通りで、これで503エラーページを上書きできます。
ApacheとTomcatを連携させてサイトを運営していると、サイトに更新をかける際に必ずTomcatをRestartさせる瞬間があります。
この際Tomcatが一時的に停止状態になるので、このわずかな時間内にサイトにアクセスした人はApacheから下のような503エラー文を見ることになります。
Copy Code
Service Unavailable
The server is temporarily unable to service your request due to maintenance downtime or capacity problems. Please try again later.
---------------------------------------------------------------------------------------------------------------------------------
Apache/x.x.xx (Ubuntu) Server at unity-engineer.top Port 443
しかしErrorDocumentをconfに書き込んでも全く反映されませんでした。
ErrorDocumentが正常に機能しない
ErrorDocument
を追記すれば本来は簡単にエラーページを上書きできるはずです。
Copy Code
DocumentRoot /var/www/html
# 503のエラーが発生した時、/var/www/html/503.htmlのページにアクセスするように設定
ErrorDocument 503 /503.html
Copy Code
<VirtualHost *:443>
DocumentRoot /var/www/html
# リバースプロキシ設定が優先されてファイルが存在していても見つからない
ErrorDocument 503 /errors/503.html
ServerName 「ドメイン名」
SSLEngine on
SSLProtocol all -SSLv2
SSLCertificateFile 「cert.pemのpath」
SSLCertificateKeyFile 「privkey.pemのpath」
SSLCertificateChainFile 「chain.pemのpath」
ProxyRequests Off
SSLProxyEngine On
ProxyPass / 「ドメイン名」/「Tomcatのサイトディレクトリ」
ProxyPassReverse / 「ドメイン名」/「Tomcatのサイトディレクトリ」
</VirtualHost>
Copy Code
Additionally, a 503 Service Unavailable error was encountered while trying to use an ErrorDocument to handle the request.
Proxy設定とProxyErrorOverrideを追加する
Copy Code
ProxyPass /errors !
ProxyPass / 「ドメイン名」/「Tomcatのサイトディレクトリ」
ProxyPassReverse / 「ドメイン名」/「Tomcatのサイトディレクトリ」
errors
というディレクトリにアクセスしてきた際はその下のリバースプロキシを実行しません。
Copy Code
ProxyErrorOverride On
ErrorDocument 503 /errors/503.html
ProxyErrorOverride On
でエラー時の遷移分けを有効化し、503エラーの時は errors
ディレクトリ下の503.htmlにアクセスするように指定しています。
Copy Code
<VirtualHost *:443>
DocumentRoot /var/www/html
ServerName 「ドメイン名」
SSLEngine on
SSLProtocol all -SSLv2
SSLCertificateFile 「cert.pemのpath」
SSLCertificateKeyFile 「privkey.pemのpath」
SSLCertificateChainFile 「chain.pemのpath」
ProxyRequests Off
SSLProxyEngine On
ProxyPass /errors !
ProxyPass / 「ドメイン名」/「Tomcatのサイトディレクトリ」
ProxyPassReverse / 「ドメイン名」/「Tomcatのサイトディレクトリ」
ProxyErrorOverride On
ErrorDocument 503 /errors/503.html
</VirtualHost>
