LoginSignup
20
18

More than 5 years have passed since last update.

JSPが文字化けしたときの対処

Posted at

むかーしに書かれたコードを触っていると、文字コードが統一されていなかったりしてJSPで作成したページが文字化けしました。
今回は文字化けの対応する中で、原因等も調べた結果をまとめます。
(統一されていれば何の問題も無いのですが・・・。)

そもそも何で文字化けするのか

Webアプリケーションで文字化けが発生する原因は、レスポンスされたHTMLのエンコーディングと、
ブラウザが解釈しようとしているエンコーディングが不一致になってしまうことです。

HTMLがUTF-8でエンコードされているのに、ブラウザがEUC-JPでエンコードしようとする、など。

ブラウザのエンコーディングはどうやって決まるのか

ブラウザは自動的にエンコーディングを判断します。

  • レスポンスヘッダのContent-Type
  • 上記がない場合は、HTMLのmetaタグにあるcharset

どちらも指定がある場合はレスポンスヘッダの方が優先されます。
文字化けの対処でmetaタグでcharsetを指定してもエンコーディングが変わらないのは、レスポンスヘッダで別のエンコーディングが指定されているためということがよくあります。

JSPの文字化け

以上を踏まえて、JSPの文字化けについて述べていきます。

レスポンスヘッダのcharset

JSPは以下のタグを指定することによって、レスポンスヘッダのContent-Typeを指定することができます。

<%@ page contentType="text/html; charset=UTF-8" %>

これで万事解決!といきたいところですが、JSPファイル自体のエンコーディングも関連してきます。

JSPの簡単な仕組み

JSPはServletに変換されます。実際にHTMLを生成、レスポンスしているのは、ここで生成されたServletです。
デフォルトでは、TomcatなどのAPサーバのworkディレクトリ内に変換されたServletが生成されています。

JSPに書かれた内容をServletに変換していきますが、ここでもエンコーディングが関わってきます。
たとえばUTF-8で作成されたJSPを、EUC-JPだと思い込んでServletに変換すると、この段階で文字化けします。

変換処理の中でJSPの文字コードをどうやって判断するか

JSPファイル自体のエンコーディングは以下のタグで指定できます。

<%@ page pageEncoding="UTF-8" %>

pageEncodingが指定されていない場合は、contentTypeのcharsetに指定された値で判断します。
つまり以下のような場合、UTF-8と判断します。

<%@ page contentType="text/html; charset=UTF-8" %>

contentTypeのcharsetとpageEncodingは異なる値を指定することができるので、
UTF-8で作成されたJSPをShift-JISのHTMLとして返却したい場合は以下のように指定することができます。

<%@ page contentType="text/html; charset=Shift_JIS" pageEncoding="UTF-8" %>

ただし、UTF-8で利用できるが、Shift_JISに含まれない文字、たとえば🍔などの絵文字とかが含まれていると、それは文字化けします。

結論

JSPのcontentTypeとpageEncodingを適切に指定しましょう。
いっそのこと全部UTF-8にしましょう。

参考

contentTypeやpageEncodingをいちいち指定するのが面倒な場合は、web.xmlに以下を設定するといいです。

<jsp-config>
  <jsp-property-group>
    <url-pattern>*.jsp</url-pattern>
    <page-encoding>UTF-8</page-encoding>
  </jsp-property-group>
</jsp-config>

これでJSPで記載しなくても、pageEncodingがUTF-8になります。
また、contentTypeを指定しない場合のcharsetはpageEncodingの指定に従うので、
JSPでは、contentTypeの指定も省略することができます。

ちなみにこの場合、web.xmlで指定した値と異なるエンコーディングをJSP側で指定すると例外が発生します。

20
18
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
20
18