Spring Bootでの国際化・時刻設定を完全ガイド！初心者でもわかる文字コード・ロケール・タイムゾーンの設定方法

1. Spring Bootと国際化（i18n）の関係とは

「1. Spring Bootと国際化（i18n）の関係とは」の重要ポイントを、初心者の方にも分かりやすく簡潔に解説します。

1. Spring Bootと国際化（i18n）の関係とは

国際化とは、アプリケーションを複数の言語や地域に対応させる仕組みのことです。英語では「Internationalization」と呼ばれ、よくi18nと省略されます。Spring Bootは、デフォルトで国際化に対応しており、適切な設定を行えば、日本語・英語・フランス語など、さまざまな言語で表示することができます。

2. 文字コード（Character Encoding）の設定方法

2. 文字コード（Character Encoding）の設定方法

文字化けの主な原因は、文字コードが一致していないことです。Spring Bootでは、UTF-8を使うことで日本語を含む多言語を正しく表示できます。設定はapplication.propertiesに記述します。

spring.http.encoding.charset=UTF-8
spring.http.encoding.enabled=true
spring.http.encoding.force=true

この設定により、リクエストやレスポンスの文字コードがすべてUTF-8に統一されます。特に、フォーム送信やAPI通信で日本語を含むデータを扱う場合に必須です。

3. ロケール（Locale）の設定と切り替え

3. ロケール（Locale）の設定と切り替え

ロケールとは、言語と地域の組み合わせを表す情報です。Spring Bootでは、デフォルトのロケールを設定したり、ユーザーの選択によってロケールを動的に切り替えることができます。まず、固定のロケールを指定する場合は次のようにします。

spring.mvc.locale=ja_JP
spring.mvc.locale-resolver=fixed

この設定により、すべてのリクエストで日本語表示がデフォルトになります。

動的に切り替えたい場合は、LocaleResolverとLocaleChangeInterceptorを使って設定します。

@Configuration
public class WebConfig implements WebMvcConfigurer {

    @Bean
    public LocaleResolver localeResolver() {
        SessionLocaleResolver resolver = new SessionLocaleResolver();
        resolver.setDefaultLocale(Locale.JAPAN);
        return resolver;
    }

    @Bean
    public LocaleChangeInterceptor localeChangeInterceptor() {
        LocaleChangeInterceptor interceptor = new LocaleChangeInterceptor();
        interceptor.setParamName("lang");
        return interceptor;
    }

    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        registry.addInterceptor(localeChangeInterceptor());
    }
}

これにより、URLに?lang=enのようにパラメータをつけることで、英語などに切り替えることができます。

4. メッセージプロパティファイルの作成

「4. メッセージプロパティファイルの作成」の重要ポイントを、初心者の方にも分かりやすく簡潔に解説します。

4. メッセージプロパティファイルの作成

Spring Bootの国際化機能では、ロケールごとのメッセージを別ファイルで定義します。たとえば、以下のようにmessages_ja.propertiesとmessages_en.propertiesを作成します。

# messages_ja.properties
greeting=こんにちは！

# messages_en.properties
greeting=Hello!

テンプレート（例：Thymeleaf）で使用する場合は、次のように記述します。

<p th:text="#{greeting}">Default</p>

5. タイムゾーン（TimeZone）の初期化設定

5. タイムゾーン（TimeZone）の初期化設定

アプリケーションが複数の国や地域で使用される場合、日時の表示も重要になります。Spring Bootでは、起動時にデフォルトのタイムゾーンを設定することで、日時のズレを防ぐことができます。

@SpringBootApplication
public class DemoApplication {

    public static void main(String[] args) {
        TimeZone.setDefault(TimeZone.getTimeZone("Asia/Tokyo"));
        SpringApplication.run(DemoApplication.class, args);
    }
}

この設定により、アプリケーション全体のタイムゾーンが東京（日本時間）に統一されます。

6. データベースとの時刻連携に注意

6. データベースとの時刻連携に注意

アプリケーション側でタイムゾーンを設定していても、データベース側の設定が異なると、保存された日時がずれることがあります。MySQLを使っている場合は、JDBCのURLにタイムゾーンを指定すると安心です。

spring.datasource.url=jdbc:mysql://localhost:3306/mydb?serverTimezone=Asia/Tokyo

また、JPAを使っている場合、@Temporalや@CreationTimestampなどのアノテーションを使って、時刻の取り扱いを明示することも重要です。

7. サーバー側（Tomcatなど）の文字コード設定

「7. サーバー側（Tomcatなど）の文字コード設定」の重要ポイントを、初心者の方にも分かりやすく簡潔に解説します。

7. サーバー側（Tomcatなど）の文字コード設定

Spring Bootアプリは、内部的にTomcatを使っていることが多いです。Tomcat側のエンコーディングもUTF-8に設定しておくと安心です。

server.tomcat.uri-encoding=UTF-8

これにより、URLパラメータやリクエストボディの文字列も、正しくUTF-8で処理されます。

8. ログ出力やファイル保存時の文字コード指定

8. ログ出力やファイル保存時の文字コード指定

ログファイルやテキストファイルを出力する際にも、明示的にUTF-8を指定しておくと、将来的なトラブルを防ぐことができます。

PrintWriter writer = new PrintWriter(new OutputStreamWriter(
    new FileOutputStream("log.txt"), StandardCharsets.UTF_8));
writer.println("ログ出力テスト：日本語");
writer.close();

ファイルを外部システムと連携する場合にも、文字コードを統一しておくことで、読み取りエラーや文字化けを防げます。