文字化けの原因切り分けと対処法（Java 標準 API で）

import java.io.BufferedReader;
import java.io.ByteArrayInputStream;
import java.io.ByteArrayOutputStream;
import java.io.InputStreamReader;
import java.io.OutputStreamWriter;
import java.io.PrintWriter;
import java.nio.charset.Charset;
import java.nio.charset.StandardCharsets;
import java.util.HexFormat;
import java.util.LinkedHashMap;
import java.util.Map;

/**
 * 文字化けの原因切り分けと対処のためのユーティリティ。
 * バイト列のダンプ、エンコーディング推定、変換を行う。
 */
public class MojibakeTroubleshooting {

    /** よく使うエンコーディングの一覧 */
    private static final Charset[] CANDIDATE_CHARSETS = {
        StandardCharsets.UTF_8,
        Charset.forName("MS932"),
        Charset.forName("EUC-JP"),
        StandardCharsets.ISO_8859_1,
    };

    /**
     * バイト列を16進数でダンプし、各エンコーディングでの解釈結果を表示する。
     * 文字化けの原因を目視で切り分けるときに使う。
     */
    public static Map<String, String> dumpWithCharsets(byte[] data) {
        var result = new LinkedHashMap<String, String>();
        var hex = HexFormat.ofDelimiter(" ").formatHex(data);
        result.put("HEX", hex);
        for (var charset : CANDIDATE_CHARSETS) {
            result.put(charset.name(), new String(data, charset));
        }
        return result;
    }

    /**
     * 文字列を指定エンコーディングのバイト列に変換し、
     * さらに別のエンコーディングで文字列に戻すシミュレーション。
     * 「この組み合わせで化けるか」を確認するのに使う。
     */
    public static String simulateMojibake(String text,
            Charset writeCharset, Charset readCharset) {
        var bytes = text.getBytes(writeCharset);
        return new String(bytes, readCharset);
    }

    /**
     * InputStreamReader / OutputStreamWriter で
     * Charset を明示指定した安全な変換を行う。
     * Shift_JIS（MS932）ファイルを UTF-8 に変換する典型パターン。
     */
    public static byte[] convertEncoding(byte[] sourceData,
            Charset fromCharset, Charset toCharset) throws Exception {
        var output = new ByteArrayOutputStream();
        try (var reader = new BufferedReader(
                new InputStreamReader(
                    new ByteArrayInputStream(sourceData), fromCharset));
             var writer = new PrintWriter(
                new OutputStreamWriter(output, toCharset))) {
            String line;
            while ((line = reader.readLine()) != null) {
                writer.println(line);
            }
        }
        return output.toByteArray();
    }

    /**
     * 波ダッシュ問題のチェック。
     * Shift_JIS と MS932 でマッピングが異なる代表的な文字を検証する。
     */
    public static void checkWaveDash() {
        var waveDash = "〜";       // WAVE DASH（Unicode 標準）
        var fullwidthTilde = "～"; // FULLWIDTH TILDE（Windows 系）

        System.out.println("=== 波ダッシュ問題の検証 ===");
        System.out.println("WAVE DASH (U+301C): " + waveDash);
        System.out.println("FULLWIDTH TILDE (U+FF5E): " + fullwidthTilde);

        var ms932 = Charset.forName("MS932");

        // MS932 でのバイト表現を比較
        var waveDashBytes = waveDash.getBytes(ms932);
        var tildaBytes = fullwidthTilde.getBytes(ms932);
        var hex = HexFormat.ofDelimiter(" ");
        System.out.println("WAVE DASH → MS932: " + hex.formatHex(waveDashBytes));
        System.out.println("FULLWIDTH TILDE → MS932: " + hex.formatHex(tildaBytes));
    }

    /**
     * defaultCharset() の確認。
     * 環境依存の挙動を把握するためのチェック用。
     */
    public static void showEnvironmentInfo() {
        System.out.println("=== 環境のエンコーディング情報 ===");
        System.out.println("Charset.defaultCharset(): "
            + Charset.defaultCharset());
        System.out.println("file.encoding: "
            + System.getProperty("file.encoding"));
        System.out.println("stdout.encoding: "
            + System.getProperty("stdout.encoding", "(未設定)"));
    }

    public static void main(String[] args) throws Exception {
        showEnvironmentInfo();
        System.out.println();

        // 文字化けシミュレーション
        var testText = "請求書　金額：￥1,000（税込）〜";
        System.out.println("=== 文字化けシミュレーション ===");
        System.out.println("元の文字列: " + testText);
        System.out.println("UTF-8→MS932で読む: "
            + simulateMojibake(testText,
                StandardCharsets.UTF_8, Charset.forName("MS932")));
        System.out.println("MS932→UTF-8で読む: "
            + simulateMojibake(testText,
                Charset.forName("MS932"), StandardCharsets.UTF_8));
        System.out.println();

        // バイト列ダンプ
        var sampleBytes = testText.getBytes(StandardCharsets.UTF_8);
        System.out.println("=== バイト列ダンプ（UTF-8 で書き込み） ===");
        var dump = dumpWithCharsets(sampleBytes);
        dump.forEach((charset, text) ->
            System.out.printf("  %-12s: %s%n", charset, text));
        System.out.println();

        // エンコーディング変換
        var ms932Data = testText.getBytes(Charset.forName("MS932"));
        var utf8Data = convertEncoding(ms932Data,
            Charset.forName("MS932"), StandardCharsets.UTF_8);
        System.out.println("=== MS932 → UTF-8 変換 ===");
        System.out.println("変換結果: "
            + new String(utf8Data, StandardCharsets.UTF_8));
        System.out.println();

        // 波ダッシュ問題
        checkWaveDash();
    }
}