先生と生徒の会話形式で理解しよう

生徒

「Micronautでアプリを起動したら、DIエラーが出て動かなくなりました。何を見ればいいんでしょうか？」

先生

「Micronautでは、DIの設定ミスがあると起動時にエラーが出ます。よくあるのがNoSuchBeanや循環依存です。」

生徒

「エラーメッセージは出るんですが、原因がよく分かりません。」

先生

「原因のパターンを知っておくと、エラーの意味が見えてきます。順番に整理して確認していきましょう。」

1. MicronautのDIエラーが起きる理由

Micronautは、起動時にDIコンテナを構築し、すべてのBeanを解決します。このとき、必要なBeanが見つからない、または依存関係が正しく解決できない場合、アプリケーションは起動に失敗します。

Springなどと同様にDIを使いますが、Micronautはコンパイル時に依存関係を解析するため、エラーが比較的早い段階で分かるという特徴があります。これは安全性が高い反面、初心者にとってはエラーメッセージが難しく感じられる原因にもなります。

2. NoSuchBeanエラーとは何か

NoSuchBeanエラーは、DIしようとしたBeanがコンテナ内に存在しない場合に発生します。つまり、注入したいクラスがBeanとして登録されていない状態です。

このエラーは、アノテーションの付け忘れやパッケージ構成の勘違いなど、初心者が最も遭遇しやすいDIエラーです。エラーメッセージには、見つからなかった型の名前が表示されるため、まずはそのクラスが本当にBeanとして定義されているかを確認します。

3. NoSuchBeanが発生する典型的な例

次の例は、サービスクラスをDIしようとしているものの、対象のクラスにBean定義がされていないケースです。


public class MessageService {

    public String message() {
        return "Hello Micronaut";
    }
}


import jakarta.inject.Singleton;

@Singleton
public class HelloController {

    private final MessageService messageService;

    public HelloController(MessageService messageService) {
        this.messageService = messageService;
    }
}

この状態では、MessageServiceにSingletonなどのアノテーションが付いていないため、 MicronautはBeanとして認識できません。その結果、NoSuchBeanエラーが発生します。

4. NoSuchBeanエラーの解決方法

解決方法はシンプルで、DI対象のクラスにBean定義アノテーションを付与します。多くの場合はSingletonを付けるだけで問題ありません。


import jakarta.inject.Singleton;

@Singleton
public class MessageService {

    public String message() {
        return "Hello Micronaut";
    }
}

これでMessageServiceがDIコンテナに登録され、 HelloControllerへの注入が正しく行われるようになります。 NoSuchBeanエラーが出たときは、まずアノテーションの有無を確認する癖をつけることが重要です。

5. 循環依存とはどのような問題か

循環依存とは、複数のBeanが互いに依存し合ってしまう状態を指します。例えば、クラスAがクラスBをDIし、クラスBがクラスAをDIしている場合です。

Micronautでは、このような依存関係は起動時に検出され、エラーとして通知されます。循環依存は設計上の問題を示していることが多く、放置するとコードの保守性が大きく低下します。

6. 循環依存が発生するサンプル

次のコードは、循環依存が発生する典型的な例です。


import jakarta.inject.Singleton;

@Singleton
public class ServiceA {

    private final ServiceB serviceB;

    public ServiceA(ServiceB serviceB) {
        this.serviceB = serviceB;
    }
}


import jakarta.inject.Singleton;

@Singleton
public class ServiceB {

    private final ServiceA serviceA;

    public ServiceB(ServiceA serviceA) {
        this.serviceA = serviceA;
    }
}

このような構造では、どちらのBeanも先に生成できず、 Micronautは依存関係を解決できません。その結果、循環依存エラーが発生します。