【初心者向けエラーシリーズ #7】Javaの「return type mismatch」とは？戻り値の型不一致で発生するエラーを徹底解説

Javaでは、すべてのメソッドにおいて「戻り値の型（return type）」を明示的に定義する必要があります。これは、Javaが静的型付け言語であり、プログラム実行前に型の整合性をチェックするためです。

メソッドの戻り値として定義された型と、実際にreturnで返している値の型が一致していないと、return type mismatch（戻り値の型の不一致）としてコンパイルエラーが発生します。

このエラーは特に初心者が見落としやすく、以下のような場面でよく発生します：

本記事では、このエラーが起こる仕組みを理解し、具体例とともに正しい対処法を身につけることで、ミスを減らしスムーズにJava開発を進められるようになることを目指します。

基本のエラー例：return type mismatch

以下は、String型の戻り値を指定しているにもかかわらず、int型の値を返してしまっているためにエラーとなる例です。

public String getNumber() {
    return 100;  // エラー：int型をString型として返そうとしている
}

Type mismatch: cannot convert from int to String

これはJavaの型チェック機構によって検出され、コンパイル時にエラーとして通知されます。

public double getValue() {
    return "3.14";  // エラー：String型をdouble型として返している
}

public double getValue() {
    return 3.14;
}

public String getValue() {
    return "3.14";
}

戻り値の型を変更する場合は、呼び出し元のコードにも影響が及ぶため、十分な確認が必要です。

public int getCount(boolean flag) {
    if (flag) {
        return 1;
    }
    // ここにreturnがないとコンパイルエラーになる
}

Javaでは、すべてのコードパスにおいて必ずreturnが実行されることが求められます。このルールを満たさない場合、コンパイルエラーが発生します。

public int getCount(boolean flag) {
    if (flag) {
        return 1;
    } else {
        return 0;
    }
}

public int getCount(boolean flag) {
    if (flag) {
        return 1;
    }
    return 0;
}

public void printMessage() {
    return "Hello";  // エラー：void型のメソッドでは値を返せない
}

public void printMessage() {
    System.out.println("Hello");
    return;  // 処理の終了を示す
}

void型のメソッドでは、return文に値を含めることはできません。処理を中断または早期終了する目的で return; のみを使用します。

次回は、Javaのメソッド呼び出しに関するよくあるエラー「non-static method cannot be referenced from a static context」について解説します。 staticメソッドとインスタンスメソッドの違いを明確に理解できるようになります。